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NOTA DO EDITOR 


Enquanto fui diretor editorial da revista MICROHOBBY, procurei sem- 
pre dar enfase ao aspecto "desafio a inteligencia” que o microcomputador re¬ 
presen ta. 

Com vista nisso, concebi desde o primeiro numero da revista uma segao 
"Quebra-Cabega" na quaI eram propostos problemas que deveriam ser resolvi- 
dos em "simbiose" com o microcomputador. Foi a maneira que encontrei 
para tentar estimular tanto a inteligencia artificial quanto a natural de meus 
leitores. 

As vezes eu exagerava um pouco na dificuldade dos problemas e 6 pes- 
soal da redagao ficava ansioso pois nao chegavam cartas com a resposta corre- 
ta para que a pudessemos publicar no numero seguinte. 

Nao uma, mas va'rias vezes fomos "salvos pelo gongo"por um leitorde 
Sao Paulo que nos enviava sempre a resposta correta e elaborada da maneira 
mais elegante poss/'vel. 

As cartas que e/e enviava mostravam nitidamente uma inteligencia bri- 
Ihante que aceitava e gostava de desafios. 0 nome dele tornou-se conhecido 
na redagao tanto quanto se ele fosse um de nos: SAMUEL EJCHEL. 

Alguem que sente prazer em pensar (especie atualmente em extingao) 
so podia ser um amador entusiasta: realmente o Samuel nao e um profissional 
do ramo e o que ele aprendeu de Unguagem de maquina , foi como auto-di¬ 
data. 

Assim sendo ele tern bem nftidas na mente as dificuldades que um ini- 
ciante na arte da computagao pode enfrentar. Ao mostrar como ele contor- 
nava essas dificuldades quando estava elaborando alguns jogos, eu send a 
tremenda importancia que essa experiencia poderia representar para outros 
programadores. 

Mais importante que o resultado, a elaboragao dos jogos tinha que ser 
transmitida aos outros usudrios. 0 melhor caminho para isso era colocar o 
Samuel dando cursos ou escrevendo um livro. 

Optamos pela segunda hipotese e o resultado af esta. Confesso que, re¬ 
lend o a obra, sinto orgulho. 

E um orgulho "obstetrico": o filho nao 6 meu, mas contribuf para que 
ele visse a luz. Meu "faro" nao se enganou: o Samuel mais uma vez aparece 
com uma solugao brilhante e elegante. 


Parabens\ 
Pierluigi Piazzi 
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Este livro 6 destinado aqueles que, conhecedores de linguagem de m5- 
quina, desejam aprender ou aprimorar-se na t^cnica de criar jogos no com- 
putador. Esta atividade, mais que outras, revela-se como um atraente e apai- 
xonante passatempo, tipo quebra-cabepas, que exige de quern o faz um gran¬ 
de esforpo de atenpao e concentrapSo, constituindo-se portanto num exce- 
lente exerci'cio para a mente. A satisfapao que se sente ao terminar um de- 
senvolvimento, e ver na tela a material izapao de uma id^ia, 6 contagiante e 
altamente gratificante. 

Programar em linguagem de maquina ja 6 de per si um desafio. Para jo¬ 
gos, o uso desta linguagem e indispensdvel, pelo menos nos microcomputado- 
res da linha Sinclair, por ser a unica compati'vel com as velocidades exigidas 
no movimentos. 

Para usufruir deste livro o leitor deve conhecer as instrupoes de miqui- 
na, ou Assembly, do microprocessador Z-80. Algumas destas instrupoes sao 
explicadas no texto, por6m a maioria assume-se comp conhecidas e, em 
caso de duvida, recomenda-se consultar a bibliografia sobre o assunto. No 
apendice A existem algumas indicapoes para isto. 

O equipamento a usar deve ser da linha Sinclair ou compati'veis, Ringo, 
ZX 81, CP 200, AS 1000, NEZ 8000, TK 82C, TK 85, TK 83, com capaci- 
dade maior ou igual a 2 Kbytes. 

Os programas apresentados necessitam para rodar, em sua maioria, algo 
perto deste limite. Assim se sua maquina tiver somente 2 Kbytes, conv^m 
conseguir uma expansao emprestada para permitir a digitapao e carregamen- 
to dos programas. 

Para carregar os programas, separados em grupos, qualquer monitor ou 
carregador de linguagem de maquina, que o leitor disponha, pode ser usado. 
Apos cada grupo, devidamente desassemblado, temos a mesma listagem em 
heptassintStico. Querendo usar esta oppao, consulte o ap§ndice B. 

Este livro 6 dividido em 6 capftulos. Em cada um 6 enfatizada uma ca- 
racteri'stica. relacionada com os jogos e e apresentado um programa ilustra- 
tivo detalhado e explicado em pequenos blocos. Varios destes cont^m rotinas 
de uso geral, que poderao ser copiadas e utilizadas de imediato em novas 
aplicapBes. Fapa bom uso delas! 
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CAPITULO 1 - A TELA 

Indiscutivelmente a tela e o elemento mais importante quando se pre- 
tende programar jogos. Enquanto que numa aplicagao mais "s6ria", a tela 6 
o meio para dar sai'da de resultados de processamento ou listagensda manei- 
ra mais clara possi'vel, nos jogos a est^tica e o dinamismo da imagem sao a 
prdpria essencia dos mesmos. 

Nos computadores da linha Sinclair o conteudo da tela esta armazenado 
na memoria em forma de urn arquivo sequential de bytes, cada urn correspon- 
dendo a urn de seus pontos. Este arquivo 6 conhecido como Dfile, abreviatura 
do inglSs Display File. 0 enderepo onde tern ini'cio 6 uma das chamadas Varia- 
veis do Sistema (como referenda ver o manual do seu equipamento) e se 
encontra armazenado no par de bytes de enderepo 16396 e 16397 (400C e 
400D em hexa). 

Para se obter com estes, o enderepo X de ini'cio do arquivo da tela basta 

fazer 


A organizagao deste arquivo € funpao da capacidade de memoria do 
equipamento. Para RAMs acima de 3,5 Kbytes tern a configurapao esquemati- 
ca apresentada na figura 1. 



F I GURA 1. 


Isto significa que a tela ocupa 793 bytes de memoria do computador, 
ou seja 24 vezes 32 bytes de cada linha da tela mais o inicial e final contendo 
a indicapao de New Line (118 ou 76 em hexa), somando 25 bytes. Todos eles 
ficam reservados somente para a tela, e podem se "mover" ao longo da mem6- 
ria, em funpao do tamanho do programa que acompanha seu uso. Todavia o 
enderepo aonde o conjunto encontra-se^em cada situapao 4 sempre indicado 
pelos valores contidos nos bytes 16396 e 16397. 


Ora, 793 bytes representam uma parcela ponderavel do total, quando a 
capacidade da RAM 4 inferior a 3,5 Kbytes. Neste caso, para economizar 
memoria, a organizagao do arquivo de tela 4 diferente: quando se liga a m4- 
quina, o arquivo content apenas os 25 New Lines (118 ou 76 em hexa), e 
cresce na medida em que se vai "escrevendo" na tela. Por exemplo, partindo 
da tela vazia, apos comandar: 

o arquivo teria a configurapao esquematica indicada na fig. 2. 



FIGURA 2 


Cabe esclarecer que nesta explicagao esta sendo omitido o que ocorre 
com as duas ultimas linhas da tela, as quais, quando se trabalha em Basic, 
ficam sob controle do Sistema gerenciador desta linguagem. Por4m ao passar 
para linguagem de maquina temos possibilidade de utilizar todas as 24 linhas 
como quisermos. O indicador do numero de linhas reservadas pelo Basic na 
parte inferior da tela, 4 a varicivel de Sistema DFSZ, de enderepo 16418 
(4022 em hexa). Mais adiante veremos como utilizar esta info^mapao. 

A fim de ilustrar os conceitos acima e introduzir novos, vamos apresen- 
tar e analisar o programa de um jogo chamado Revertendo. A id^ia do jogo 
consiste no seguinte: 

* 0 jogador, de ini'cio, define um numero — o "Ni'vel de Dificuldade" — que 
serS utilizado no programa para compor a tela ou tabuleiro do jogo. 

* 0 computador inicialmente constroi a tela base, que consiste em uma mol- 
dura de orientapao, com letras no sentido horizontal e numeros no vertical, 
totalmente cheia de si'mbolos "+". 

* Em seguida o programa sorteia um numero de posipoes da tela igual ao Nf- 
vel de Dificuldade eleito pelo jogador, e faz uma modificapao do conteudo 
de cada uma delas e das oito posipBes que cercam a sorteada (se l£ havia uma 
+ passa a um H e vice-versa). 

* Cabe ao jogador, atrav^s de lances, definindo a coluna (letra) e a linha (nu¬ 
mero), indicados nesta ordem, reverter (daf o nome do jogo) o tabuleiro as 
condipoes primitivas. 





* Finalizando, o computador relembra o rn'vel de dificuldade escolhido, e in- O programa 

forma o numero de jogadas ou lances feitos pelo r s jogador. A comparagao des- 

tes dois valores da a nogao do desempenho atingido na partida. Embora nao 

seja indispensavel, 6 recomenddvel que se faga e use o diagrama de biocos do 

programa. Isto serve para fixar o racioci'nio e evitar erros. 



10 


Basic correspondente 6 o seguinte. 





















A correlapao entre as instrupoes do programa e os blocos e a seguinte: 


BLOCO 

2 

3 

4 

5 

6 


9 

10 

11 

12 


instruqOes 

3 e 5 
10 

15 a 28 
30 a 49 
60 a 106 
1000 a 1019 
125 
200 

205 a 230 
235 

241 a 250 
1050 a 1080 
1090a 1110 
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Observe agora o programa, a partir da linha 50 atd a sub-rotina 1000 
(inclusive), e veja como a tela esta sendo alterada. A variSvel V da linha 50 na- 
da mais 6 senao o enderepo que se encontra na Variavel de Sistema DFile que 
falamos acima, e portanto corresponde ao ini'cio do arquivo da tela. 

Para entender as instrupoes seguintes, convent fazer um esbopo da tela 
como o que apresentamos na figura 4. Alias, quando se programa em lingua- 
gem de miquina, a confecpao deste esbopo 6 praticamente indispensSvel. En- 
tao, caso voce deseje prosseguir e bom jS ir providenciando um bloco ou ca- 
derno com papel quadriculado, ou tirandp cdpias do apendice D. 



L 

Bl 


E 

E 

G H 1 

'ilL'k 

noF 

EEaili^ 

a 

Ip 


201 + 
’02±i 
->02 + 

T 

Th 

FT 

+ 

± 

+ + + 

+ + + + 

+ + + 

+ + + + + + 

+ 

±± 

+ +012 

T 

+ 


T 

+ 

+ + + 

+ + + + 

+ + + 

+ + + + -+ + 

+ 


+ +03> 

50 4 + 
601±| 
702+J 

+ 

+ H 

Nil 

+ 

h + 

:v 

+ 

E 

+ 

4 

L 

+ + - 
DE 
-+ + + 

4- 4- 4-4- 
DIF 
-+ + + + 

1 C RJ L D A D E 


4- 4- 

4 4 0 6 7 

8 0 7 + 

4- 

-+■ 

-+■ 

+ 


V 0TC E l. C NiS E 

GU 1 U + 

4- 

4-4- 


9 0 8 + 

4 

4- 

*4 

4- 

-+ 

T 

+ 

EMJ 

+ + + 

111 
+ + + + 

DUD 

4-4-4- 

ADAS + 
+ + + -+ + + 

+ 

4- T 

ttzi » 

’1.2 + 
12 1 + 

±1 

4- 

m 

4- 

+ 

+ 

+ 

-+ + + 
+ + + 

+ + + + 
+ + + + 

+ +-+ 

+ + + + + + 
-+-F + -+ + -+ 

+ 

t 4 
±± 

+ + 12” 

+ + 1 1 12 

13 2 + 


4- 

+ 


N 

U Y. ii 

1JI01GI0P7T 

( S 7 N ) 


4 4- 

+ + 1 2 13 

’1.3 + 


4- 


+ 


+ + + 

+ + + + 

4-4 4- 

+ +■+ + + + 

+ 

T|4 

4 + n» 

15 4 + 


+ t 

4- 

4* 



+ + + + 

+ + + 

+ + + + + + 



+ + 1 4 15 

’1.5 + 



4- 

4- 


+ + + 

+ + + + 

+ + + 

+ + +++ + 


±T 

+ + 1 5 15 

17 6 + 


+ 

4- 

4 

+ 

4-4-4- 

+ + + + 

+ + i 

+ + + + + + 

+ 

+■ 4- 

+ + 1 S >7 

18 _7t 


4- 


4- 

+ 

4-4-4- 


+ + + 

+ + + + + + 


4- 4- 

+ + 1 7 18 


±l±Ji 


4 

+ 

-4 4-4- 

+ + + + 

+ + + 

+ + + + + + 


4 4 


silt 

A 


HD 

£ 

£ 

gIhIi IjIkIlImInIoIp 

+ + + + + + 
QRSTUV 

W 

4 4 
















T 

4 

4 

T 

T 

44 

444 

[Hi 


« 



FIGURA 4 


Com o auxi'lio do esbopo torna-se mais facil observar que a variavel x, 
gerada na instrupao 105 e variando de 4 a 29, corresponde a uma das colunas 
identificadas pelas letras, e a Y, gerada na 106 variando de 2 a 19, esta ligada 
as linhas. Com a variavel P da instrupao 1000, obtida a partir das anteriores, 
chega-se ao enderepo no arquivo da tela da memoria do ponto a ser converti- 
do. Correlacione a figura 1 com a 4 e entenda como isto se processa. Note que 
o que esta sendo dito 6 valido tanto para maquinas com mais ou com menos 
que 3,5 Kbytes que, neste ultimo caso, como a tela estS totalmente ocupada, 
o seu arquivo na memoria estarS completo e ser3 igual ao daquele com mais 
de 3,5 Kbytes. 

As instrupoes seguintes, de 1010 a 1018, fazem a conversao, ja que elas 
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"pegam" (Peek) o que esta numa posigao de memoria, e subtrai'ndo 128 (so- 
mar 128 seria a mesma coisa), inverte o "fundo" do sfmbolo grafico que la 
estava, e o "recoloca" (Poke) no mesmo lugar. r 

Outro bloco que merece uma analise 6 o*11, onde o computador verifi- 
ca se a tela voltou ao que era, ou seja, se ja nao existe nenhum H (codigo 
149) nela. Para isto parte-se novamente de V e percorre-se todo o arquivo util 
da tela (726 = 33 x 22), conforme indicam as instrugoes 242 a 248. 

Digite agora o programa e faga-o rodar. Frustante! 0 tempo que a tela 
fica apagada enquanto se processa a rotina do bloco 11 e realmente muito 
grande para ser agradavel. O primeiro impulso 6 eliminar a rotina, substitum- 
do-a por urn comando manual. Afinal o jogador esta vendo que ja "limpou" a 
tela e pode dar este comando. 

Faga entao o seguinte: digite uma nova linha como segue 


Elimine as instrugoes 241 a 250 (inclusive) e mais a 1085, e introduza 
as seguintes novas instrugoes 



Faga o programa "rodar" de novo e observe como tudo mudou! Veja- 
mos o que foi feito: 

Na instrugao REM temos 

2AOC40 LDHL(DFile) 

01D6 02 LD BC, 726 d 

3E95 LD A, 149 d 

EDB1 CPIR 

C9 RET 

Consultando-se a bibliografia constata-se que CPIR funciona do seguin¬ 
te modo: compara o conteudo do enderego apontado por HL com o valor de 
A e decrementa BG; a instrugao 6 interrompida em duas situagoes, ou quando 
A = (HL) ou se BC atinge zero.(neste ultimo caso o "flag" zero 6 "setado" e 
instrugSes condicionais sao possfveis). Ou seja, este pequeno conjunto de 
bytes faz exatamente o que a rotina anterior fazia, por6m em veiocidade mui¬ 
to maior. 

Quando retorna ao Basic, o sistema traz junto com o argumento do 
USR o conteudo do par BC, ou seja, apos a instrugSo 244 a variavel K fica 
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igual ao ultimo conteudo de BC. Com isso sabe-se se nao existe mais gjj na 
tela, ja que nesta situagao K = 0. 

Vamos agora reformular o programa de modo a utilizar muito mais as 
rotinas em linguagem de maquina. O novo Basic 6 o seguinte: 



0 diagrama de blocos, como era de se esperar, 6 o mesmo que foi apre- 
sentado na figura 3, porem com uma alteragao — a utilizagao de duas sub-roti- 
nas distintas para modificar o conteudo da posigao e dos 8 vizinhos (bloco 6), 
uma para acompanhar o bloco 10 e outra, bem mais rapida, para atuar junto 
ao bloco 5. 

A correlagao entre blocos e instrugoes passa a ser: 

BLOCO INSTRUgSES 

1 710 a 720 

2 730 

3 e 4 740 a 750 

5, 6 e 7 760.a 840 

8 860 

9, 10, lie 12 870 a 890 

14 900 a 940 
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No programa em linguagem de maquina vamos nos utilizar de quatro 
conjuntos de bytes, que funcionam como registradores, escolhidos para man- 
terem dados ou participarem na I6gica de programagao. Este tipo de "registra- 
dor improvisado" 6 comumente usado quando se programa em Assembly. 

Lugares bons para serem escolhidos sao os bytes vazios na regiao das va- 
riaveis do Sistema, sejam o 16417 (4021 em hexadecimal), o par 16507/8 
(407B/C) e os bytes do "buffer" da impressora 16444 a 16475 (403C a 
405B). Note-se que o buffer da impressora 6 apagado quando se retorna para 
o Basic, mas se mantem quando vai para a linguagem de maquina. Os motivos 
para escolher esses bytes sao: 

* Eles nao apresentam desvantagem em relagao a qualquer outro que fosse es- 
colhido. 

* Normalmente um registrador nao precisa (e talvez nem deva) ficar no meio 
programa. 

* Estes bytes representam pontos fixos na memoria e assim, quando se move 
o programa de uma regiao a outra, nao § necessdrio mudar o enderego de cha- 
mada. 

* Os tres primeiros bytes citados sao preservados pelo SAVE e nao sao apaga- 
dos por CLEAR ou RUN. 

Quando se utiliza este tipo de registrador e comum batizd-lo com um 
nome sugestivo para identifica-lo e facilitar a programagao. Os quatro registra¬ 
dores que definimos sao os seguintes: 

NOME CCDIGO ENDEREQO 

Contador Cont 16507/8 (407B/C em hexa) 

Transference de X TrX 16444 (403C em hexa) 

Transference de Y TrY 16445 (403D em hexa) 

Registro de Ni'vel de TEX 16536 a 16538 (4098 a 40AO 

Dificuldade (3 bytes) em hexa) 

0 programa em linguagem de maquina serci apresentado em grupos e 
sub-rotinascorrelacionadas tanto quanto possi'vel com os blocos do diagrama 
que apresentamos (fig. 3). Para carregar o mesmo, bem como todos os demais 
programas apresentados neste livro, o leitor podera utilizar qualquer carrega- 
dor que disponha, assumindo sempre que o bloco em linguagem de maquina 
esteja concentrado numa unica linha REM, partindo do enderego 16514 
(4082 em hexa). Como foi dito na falta de um carregador proprio, apresenta¬ 
mos um no apendiceB . Como simbologia, espagos em branco serao apresenta¬ 
dos por b. 
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Grupo 1 - 16514 a 16576 (4082 a 40CO em hexa) 

b NlVEL b DIFICULDADE bbbbb VOCE b CONSEGUIU b b NOVO b 
JOGO? (S/N) b 

Este grupo e todo especial. Ele content o texto que sera usado na finali- 
zagao (bloco 12), e apresenta mais uma particularidade interessante: os tres 
bytes centrais dos 5 espagos que seguem a frase "Nivel de Dificuldade" cor¬ 
respondent justamente ao registro TEX que foi criado. Note (pelo basic) que 
ap6s o uso, no bloco 5, do ni'vel escolhido pelo jogador esta informagao so 
sera necessaria na finalizagao. Assim, nada melhor do que ja deixa-la num 
lugar favoravel para a tarefa final. 



Grupo 2 - 16577 a 16590 (40C1 a 40CE em hexa) 



Agora zeramos o contador (equivale ao bloco 7) e os dois ultimos bytes 
Y KX. Isto e necessario para evitar que ao reiniciarmos um jogo, permane- 
gam as informagoes do anterior. 



Grupo 3 - 16591 a 16618 (40CF a 40EA em hexa) 

4.0CF 2fi 10 48 LD HL, (UhR5> 
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Este grupo corresponde ao bloco 3, De infcio tomou-se o valor registra- 
do no campo das variaveis (VARS) que acabou de "entrar" (Input FS). 

A rotina do Sinclair localiza a String atrav^s da Variavel de Sistema 
VARS (16400 ou 4010 em hexa) que informa o enderepo onde ela foi arma- 
zenada. 0 byte deste enderepo content o cbdigo da letra associada ao string, 
somado com 40, os dois seguintes sao o comprimento da string, primeiro o 
menos significativo e o segundo mais significativo. Entao em nossa rotina, ao 
fazer Inc HL - LD A, (HL) - CP 4 - Ret P - And A - Ret Z - Inc HL - 
LD A, (HL) — And A — RetNZ, estamos verificando se o comprimento d 
maior que zero, mas menor que 3, e em caso contrdrio, retornando ao basic. 
Neste caso tornamos o V da instrupSo 740 diferente de zero ja que, nesta si- 
tuapao, BC ]& content o enderepo de TEX. 

Os bytes seguintes content os dados da propria "String" que entrou, e 
as demais instrupoes de grupo verificam se eles sao realmente numeros e os 
carregam rio registro TEX. 


Grupo 4 - 16619 a 16752 (40EB a 4170 em hexa) 


40F4- 

40F5 

4-0F6 

4-0F7 

40F9 

40FC. 

40FF 

4100 


Fh ST 
HL. /Si l 
f\> 21 ( D) 


L 

NZ44-0F1 
HL/(L-FI 
412F 
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Como ve-se este grupo esta dividido em um basico de 16619 a 16686 
(40EB a 412E em hexa) e quatro sub-rotinas de 412F a 4146, de 4147 a 
4156, de 4157 a 4164 e, finalmente, de 4165 a 4170. 

Existem alguns pontos que merecem comentarios: a primeira ihstrugao 
do grupo basico - CD230F - e uma chamada S rotina da ROM OF23, que 
corresponde ao comando Fast. Este tipo de procedimento, o uso de rotinas 
prontas da ROM, a muito comum em programagao em linguagem de maqui- 
na. Por isso temos no apSndice B a lista de rotinas dispom'veis na ROM. 

O conjunto seguinte, LD HL, 704 — LD A, 21 — RST 10 — Dec HL — 
LD A, H - ORL - JRNZ, a tambem muito importante. Nele a usada a ins- 
trugao RST 10 que nada mais a do que uma chamada (CALL) a sub-rotina 
que se inicia no enderego 10 da ROM, e que corresponde ao comando de im- 
primir na tela o que se encontra em A. A sub-rotina ja garante que nao sera 
ignorado o byte contendo 118 (76 em hexa) ao fim de cada linha; por isso 
6 que 6 suficiente carregar HL com 704 (= 32 x 22) e nao 726 {= 33 x 22). 
Com esta sequencia tambdm garante-se, caso o equipamento tenha menos que 
3,5 k, que o arquivo da tela corresponda a mesma totalmente "cheia". 

As demais instrugoes e sub-rotinas nao sao difi'ceis de entender. Tendo 
o arquivo da tela totalmente "cheio" como se garantiu no conjunto anterior, 
podemos compor a tela atrav<§s de "cargas" (Load) adequadas, sem necessida- 
de do uso de RSTIO. £ o que se esta fazendo por exemplo, com a sequencia 
LD HL (DFile) - LD B, 3 - Inc HL - LD (HL), 08 - DJNZ, em que se colo- 
ca na tela 3 vezes o sinal grafico correspondente ao cddigo 08. 

Ainda a neste grupo de instrugSes que pode ser visto a importancia de 
fazer o esbogo da tela. A contagem dos espagos para sair de uma posigao e 
chegar a outra, onde se "carregard" um sinal grafico qualquer, a bastante 
facilitada com o uso do esbogo. Note que um erro de posicionamento pode 
desorganizar o arquivo da tela. Isto a especialmente verdadeiro quando se car- 
rega na posigao de fim de linha, um valor que nao seja 118 (76 em hexa). 
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Quando este programa foi inicialmente criado, pretendia-se usar uma 
unica sub-rotina - a do bloco 6 - para gerar a tela (anexa ao bloco 5) como 
para "revert§-la" (anexa ao bloco 10). Posteriormente, para ganhar tempo e 
melhorar o programa, foi introduzida uma sub-rotina propria - com irn'cio 
em 4254 - para gerar a tela. 0 grupo 5 corresponde entao ao bloco 6 asso- 
ciado h reversao (bloco 10). 

TrSs pontos merecem destaque neste grupo: 

* A forma como esta sendo feita a comunicapao entre o basic (Poke 16447, 
x) e a linguagem de maquina [LD HL, TRX — LDB, 00 — LDC, (HL)]. 

* A sistematica de "consumir" tempo que e extremamente usada em progra- 
mas, aplicavel a qualquer par de registradores (no caso usamos o BC) — LD 
BC, 0300 - DEC BC - LD A, C - OR B - JRNZ - onde o valor que se car- 
rega os registradores, 0300 no caso, deve ser ajustado de forma a causar o 
efeito desejado. 

* Os 6 bytes vagos ao fim da sub-rotina ou do grupo sao uma reserva para 
a eventualidade de ser necessaria uma correpao no programa, e prevS-la 6 uma 
pratica muito recomendavel mesmo para programadores bastante experientes. 
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Neste grupo esta se repetindo rotinas ja conhecidas: do infcio at6 16899 
(4203 em hexa) tem-se o mesmo teste basico usado no grupo 3 e que corres- 
ponde ao bloco 9 do diagrama de blocos; em seguida ha a chamada 3 sub- 
rotina de reversao (grupo 5) e o incremento no contador, para finalmente 
chegar-se ao bloco 11 de verificaqao de retorno 3 tela basica, cujas explicates 
e instrupoes foram dadas quando "melhoramos" o programa original total- 
mente em basic. 



Grupo 7 - 16928 a 16979 (4220 a 4253em hexa) 
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Este grupo corresponde ao bloco 12. Trata-se apenas de compor’a tela 
final, usando os dizeres preparados no grupo 1, que como foi visto, ja cont^m 
a informapao do m'vel de dificuldade eleito pelo jogador. 

Adicionalmente cabe chamar atengao sobre a t^cnica utilizada na trans- 
cripao, com o uso da instrupao LDIR, bem como o fato de carregarmos em 
BC o valor contido no contador de forma a levar para o basic, atraves da va- 
riavel V, o numero de jogadas utilizadas. 



Grupo 8 - 16980 a 17047 (4254 a 4297 em hexa) 
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RESUMO 



Como ja foi explanado, aqui temos uma repetipao da sub-rotina 6 (gru- 
po 5) que foi feita sem dispendio de tempo, visando agilizar a montagem da 
tela inicial. 

Com este grupo de instrupoes finalizamos o programa em linguagem de 
maquina. Apos carregar e roda-lo notar-se-a que ele nao apresenta grande 
vantagem em desempenho se for comparado com versao em basic, "melhora- 
da" atravds do acr^scimo da sub-rotina de verificagao do final. 0 ponto de 
maior realce, al6m do cunho didatico, e a extensao do programa, que na ul¬ 
tima versao cabe perfeitamente em 2 Kbytes e nas primeiras exigia capacidade 
alem desta grandeza. 


Foi abordado no presente capftulo o seguinte: 

* O arquivo da tela 

* Variaveis do Sistema: DFile, Vars e DFSZ 

* T^cnicas de passagem de dados do Basic para rotinas em Linguagem de ma¬ 
quina e vice-versa. 

* Definipao de "registros improvisados" e locais interessantes para sua arma- 
zenagem 

* Uso de diagrama de blocos e do esbogo da tela. 

* Apresentapao de rotina para consumir tempo 

SUGESTOES 

1 - Procurar entender porque e indispensavel. a instrupao 855 CLEAR no 

basic 2. 

2 - Se seu equipamento tiver somente 2K procurar modificar o programa 

de forma a englobar, na linguagem de mdquina, as instrupoes 710 CLS e 
720 PRINT “NIVEL DE DIFICULDADE"; AT 0,0;. Caso tenha mais 
que 2K, introduzir tambem telas com instrupoes do jogo, usando so¬ 
mente linguagem de maquina. 
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k qui vemos como uti- 
^ lizar a rotina de lei- 
JLtura do teclado simu- 
lando o INKEY$ em 
linguagem de maquina. 
Tudo que ora se discute 
e exemplificado na cria- 
<pao do jogo "Crepe" 
onde se mostra tambem 
uma maneira muito ori¬ 
ginal de se criar nume- 
ros ao acaso sem que £ 
sorte seja ludibriada 
Alea jacta est. 



CAPITULO 2-0 TECLADO 


A pesquisa ou "varredura" do teclado 4 feito, nos computadores da li- 
nha Sinclair, atraves de uma sub-rotina da ROM conhecida por KScan, abre- 
viatura do ingles Keyboard Scan. 

Esta sub-rotina acha-se situada no enderego 699, ou 02BB em hexade¬ 
cimal, e similarmente a qualquer outra, pode ser chamada atrav4s da instrugao 
Call (CDBB02). Como em sua utilizagao todos os registradores sao afetados, 
se o conteudo de algum deles precisar ser preservado, 4 necessdrio acumula-lo 
no "stack" atrav4s da instrugao PUSH, e ap6s o Call, buscar a informagaode 
volta atrav4s do POP. 

O resultado da aplicagSo do KScan 4 encontrado no par HL, que fun- 
ciona como um apontador ou indicador de qual tecla foi digitada, se 4 que al- 
guma foi. Para entender como achar a tecla pressionada atraves do resultado 
acumulado em HL devemos considerar o teclado dividido em grupos. No caso 
do registrador L tem-se os seguintes grupos e correspondentes valores do mes- 


GRUPO DE TECLAS VALOR DE L 

Nenhuma foi pressionada FF 

Z-X-C-V FE 

A-S-D-F-G fd 

Q-W-E-R-T fb 

1-2-3 -4 -5 F7 

6—7—8 — 9—0 EF 

Y-U-l-O-P DF 

H—J — K — L — (ENTER ou 
NEWLINE) BF 

B — N — M — (.,) — (Space) 7F 


Como v4-se a tecla "Shift" nao participa de grupo algum dos citados. Isto 
significa que o fato dela estar pressionada ou nao, em nada altera o valor de 
L. 0 mesmo conceito se aplica ao registrador H, s6 que neste caso, seu valor 
muda se a tecla "Shift" estiver ou nao pressionada. 
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GRUPOS DE TECLAS 


VALOR DE H 

Sem "Shift" Com "Shift" 
Nenhuma (alem do "Shift") FF FE 

A-Q-1 - 0-P- (Enter) - 

(Space) FD FC 

Z—S—W — 2 — 9—0 — L — (.,) FB. FA 

X — D — E—3 — 8 — I — K — M F7 F6 

C - F - R-4-7 - U - J - N EF EE 

V — G—T — 5 — 6—Y — H —B DF DE 

Observando o teclado do equipamento e localizando os grupos citados, 
sera facil notar que o sistema 4 organizado como uma rede sobreposta ao con- 
junto. Dessa forma, so existe uma tecla que pertence simultaneamente a dois 
dos grupos citados, o que correspond^ a uma relagao direta entre a tecla e o 
resultado em HL. Exemplificando, pressionar a teclar A, sem "Shift", resulta 
em HL = FDFD, e em correspondence, nao 4 possi'vel chegar-se a este valor 
pressionando qualquer outra, ou conjunto de outras teclas. 

0 funcionamento desta sub-rotina 4 similar ao da fungao INKEY$ do 
Basic, a qual alias faz uso da KScan. Assim, num programa no qual se deseje 
que o sistema aguarde o pressionar de uma tecla, 4 preciso incluir um conjun¬ 
to de instrugoes equivalente a 

Caso isso nao seja feito, ao atingir o KScan ter-se-4 apenas o valor F 
FFF em HL e as instrugoes seguintes serao executadas sem maiores delongas. 

No programa que vem a seguir, chamado "CREPE", existe uma rotina 
de espera inclui'da al4m da ilustragao de outros conceitos queforam apresen- 
tados. 

0 "CREPE" 4 uma versSo para o computador do famoso jogo de azar 
homonimo, tamb4m conhecido por "seven-eleven". Para quern nao frequenta 
cassinos descrevemos as regras basicas. 

* Um dos participantes do jogo assume a posigao de "banqueiro" e enfrenta 
apostas dos demais. 

* Cabe 4 banca ou banqueiro o langamento de um par de dados. 

* A rodada se define em duas situagoes: 

** No primeiro lance de dados, se a soma dos pontos for 2, 3 ou 12 a banca 
perde e se for 7 ou 11 a banca ganha. 

* * Nao se resolvendo a rodada no primeiro lance, ou seja, se a soma dos 
pontos obtidos tiver sido um dos seguintes 4, 5, 6, 8,9 ou 10, ele sera chama¬ 
do de "ponto" e a banca joga com o mesmo contra o 7. Isto significa que o 
banqueiro ira langar os dados tantas vezes quantas forem necess4rias at4 sair 
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o valor do "ponto" novamente, caso em que ele ganha, ou sair o 7, situapao 
em que a banca perde. 

Isto posto, cabe seguir a sistemdtica recomendada e ja exposta no capf- 
tulo anterior, com a apresentapSo do diagrama de blocos, figura 5, e o esbopo 
da teia na figura 6. 
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0 basic correspondente se resume a 


£ facil notar que o programa em si e inteiramente escrito em linguagem de 
maquina, e nao necessita mais que 2 Kbytes de capacidade para rodar. Apesar 
do desempenho ser simples, foram utilizadas t^cnicas requintadas em sua ela- 
borapao o que o torna bastante didatico. 

Na conceppao do programa foi assumido que o equipamento tenha ca¬ 
pacidade menor que 3,5 Kbytes, ou mais exatamente 2 Kbytes. Como foi ex- 
plicado no capi'tulo anterior, a diferenpa basica ocasionada pelas diferentes ca- 
pacidades di.a forma de manipular a tela. Justamente para enfatizar este ponto 
6 que adotou-se este criterio. Assim se o microcomputador tiver mais que 
2 Kbytes e necessario alterar a Variavel do Sistema conhecida por Ram Top 
ou RTP, cuja localizapao esta em 16388/9, dando uma instrupao direta Poke 
16389, 72 seguido por NEW. Com isso o comportamento da maquina sera si¬ 
milar ao de uma com somente 2 Kbytes. 

Aqui cabe uma explicapao — a variavel RTP guarda o enderepo do ulti¬ 
mo byte dispom'vel na memoria. Dai' a razao do nome Ram Top. Este endere¬ 
po estd armazenado na forma tradicional, ou "invertida", usada na I6gica Sin¬ 
clair. Assim se houver 16 Kbytes dispom'veis, em 16388 haver3 urn zero e em 
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16389 o valor 128. Ora 128x 256+ 0 = 32768 que subtrafdp do im'cio da 
Ram (16384), resulta em 16384 bytes disporu'veis, que nada mais sao que 16 
vezes 1 Kbyte, ja que 1 Kbyte = 1024 bytes. Ao dar o comando Poke 16389, 
72 obt6m-se 72 x 256 + 0 = 18432 que subtrai'do do im'cio da Ram (16384) 
resulta em 2048 bytes ou 2 Kbytes. 

O comando NEW que segue & indispensavel para que o sistema se conso- 
lide na nova configurapao, agindo como tendo somente os 2 Kbytes disponf- 
veis. 

Ap6s os comandos citados carrega-se o programa, usando o LOAD. Se 
entao gravarmos a fita usando o GOTO 10 toda a vez que voltarmos a carre- 
gar o programa com o LOAD, ele entrara em execupao automatica e se com- 
portara adequadamente mesmo que nao se tenha previamente executado a al- 
terapao da RTP descrita. Isto ja nao sera verdade, se ao inv6s do GOTO 10, 
for utilizado o comando direto SAVE "CREPE". Convent analisar o que foi 
dito e entender bem a razao desta forma de ser. 

Como no exemplo do capi'tulo anterior vai-se agora desmembrar o pro¬ 
grama em grupos de instrupoes, correlacionando-os com os blocos do diagra- 
ma da figura 5. 

Grupo 1 - 16514 a 16549 (4082 a 40A5 em hexa) 

Aqui.estao contidos os 36 resultados possfveis, ou oppoes, do lanpamen- 
to dos dois dados, armazenados da seguinte forma: em cada byte os primeiros 
4 bits content o resultado de um dos dados, que 6 urn numero de 1 a 6, e os 
4 restantes o do outro dado. 

Uma das oppoes sera sorteada e utilizada para montar a figura dos dados 


Grupo 2 — 16550 a 16555 (40A6 a 40AB em hexa) 

Nestes bytes esta a palavra "Ganhou" que sera utilizada para finalizapao 
da rodada, no bloco 16. 
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£ uma pr^tica comum e conveniente esta de armazenar no infcio do 
programa informapoes que nao participam da logica, e que sao apenas usadas 
para consulta ou composipao das telas de abertura e finalizapao. Outra alter¬ 
native adotada e fazer a armazenagem apos o fim do programa, deixando po- 
rem, por cautela, alguns bytes de reserva para o caso de ser necessdrio alguma 
alterapao imprevista no programa. 


Grupo 3 - 16556 a 16854 (40AC a 41D6 em hexa) 



Este grupo content as instrupoes e dados para montagem da tela de 
abertura e corresponde ao bloco 1 da figura 5, ou im'cio do programa. 

A logica utilizada nesta tarefa e bastante interessante. A instrupao 20 do 
Basic faz uma chamada ao enderepo 16568, e la encontramos um Call para o 
im'cio da logica, em 16556 (40AC em hexa). Toda vez que um Call 6 feito, o 
enderepo do byte imediatamente apos a instrupao 6 armazenado no "stack" 
para ser usado por ocasiSo do retorno. Surgindo a instrupao Ret o enderepo e 
retirado do "Stack" (como se fosse um "Pop") e a proxima instrupSo que 6 
executada 6 a deste enderepo. 

Ora, ap6s o CDAC40 esta o primeiro byte a ser "escrito" na tela. Ele 6 
entao armazenado no "stack", de la retirado (El — Pop HL) e registrado em 
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A [7E - LD A, (HL)]. 0 enderepo e entao incrementatio e novamente arma- 
zenado no "Stack", substitumdo assim o anterior (23/E5 — Inc HL/ Push 
HL). 0 valor de A e comparado com FF, que e o indicador escolhido de fim 
do arquivo de compor a tela (FEFF — CP FF); sendo igual 6 dado o retorno 
(C8 — Ret Z) ou um "jump" para a instrupao cujo enderepo esta no stack, 
que 6 exatamente a primeira apos FF, e corresponde ao ini'cio do bloco 2. 
0 proximo passo 6 novamente um Call (CD0808), que 6 uma chamada a uma 
rotina da ROM de enderepo 2056 (0808 em hexa), responsavel por escrever 
o conteudo do registrador A na tela; esta rotina faz uso do RST 10 citado no 
capftulo anterior. Finalmente tem-se um "jump" relativo para o reim'cio do 
ciclo. 

Em relapao aos dados usados para compor a tela existem varios pontos 
dignos de nota: 

* Toda a vez que o valor de A for 118 (76 em hexa) a rotina CD0808 bem co- 
mo a RST10 entende que deve interromper a linha e pular para o ini'cio da 
seguinte. 

* * Existe uma superabundance de zeros a serem impressos. £ claro que se 
poderia reduzir o numero de bytes necessarios para compor a tela, usando ro- 
tinas auxiliares. Mas em favor da didatica e por nao ser necessario economizar 
bytes, adotou-se esta apresentapao. Como resultado, sabendo que se ira teori- 
camente trabalhar com uma capacidade de 2 Kbytes, tem-se entre 16571 e 
16853 uma copia fiel do arquivo da tela, o que facilitara o entendimento das 
etapas seguintes do programa. 

***Tambem a ti'tulo ilustrativo de recursos, e nao para economizar memoria 
neste caso, escolheu-se armazenar as palavras "Perdeu" e "Vai jogar? (S/N)" 
nos mesmos locais em que se reservaria espapo no arquivo da memoria para 
escreve-las, ou seja, nos enderepos 16617 (40E9 em hexa) a 16839 (41C7 em 
hexa) respectivamente. Como consequencia, ao montar a tela ela aparece com 
a indicapao equivalente a de ja ter havido uma rodada anterior em que a banca 
perdeu. 
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Eis o bloco onde se utiliza a KScan, que eode numero 2. 

De im'cio se compara o valor de HL correspondente a tecla pressionada 
(se 6 que houve alguma), com EF 7F que corresponde a letra N, atrav^s do 
SBC HL, DE. Sendo zero a diferenga, o N teria sido acionado e o "jump" se 
daria (CA 0000). Pular para o enderego 0000 e equivalente ao RST 0, e a 
consequencia 6 a mesma que desligar e voltar a ligar o computador, ou seja, 
a memoria 6 totalmente apagada al6m mesmo do que o NEW executa, ja que 
com esta ultima instrugao o valor da RamTop e tudo que Ihe fica acima 6 
preservado. 

Apos a subtragao o HL fica alterado e o valor que se carrega entao em 
DE 6 a diferenga entre o valor associado k tecla S (FBFD) e o da N jEF7F). 
Entao executando nova subtragSo, se o resultado for zero k sinal que a tecla 
S foi pressionada e o programa segue para o bloco seguinte. Em caso contrario 
o JR NZ faz retomar o sistema para oKScan, e assim fica formado urn lago ou 
"loop" que so e "quebrado" quando uma das duas teclas S ou N, for aciona- 
da. 

Os cinco bytes em branco seguintes sao reserva para eventuais altera- 

goes. 



Grupo 5 — 16880 a 16910 (41F0 a 420E em hexa) 
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Este grupo corresponde ao bloco 3 da figura 5, onde alguns dizeres da 
tela devem ser apagados. 

De sugestivo convent enfatizar o enderego ou localizagao do que deve 
ser apagado. Se a tela estivesse "cheia" como comumente ocorre, a segunda 
instrugao ao inv6s de ser 112200 — LD DE, 34 decimal seria 116F00 — LD 
DE, 111 decimal. Procure entender bem o porque. 



Grupo 6 - 16911 a 16954 (420F a 423A em hexa) 
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Temos aqui uma repetigao da logica do grupo anterior. Trata-se do blo- 
co 4 figura 5 em que, ao inves de dizeres, apagam-se os dados. 



Grupo 7 - 16955 a 16982 (423B a 4256 em hexa) 

4-23B CD BB C2 L'HLL KsuhN 



Af esta um grupo muito interessante. Ele corresponde aos dois blocos 
seguintes da figura 5, quais sejam o 5 e o 6. 

De im'cio tem-se uma rotina equivalente h seguinte instrupao em Basic: 

100 IF INKEY$ = ""THEN GOTO 100 
Isto porque, incrementando o L apos o KScan (CDBB02), so teremos zero 
se HL for FFFF, ou seja, se nenhuma tecla estiver sendo pressionada. Caso 
contrdrio o JRNZ obriga o sistema a voltar ao KScan e tem-se um "loop" for- 
mado. Com isso, se apos a oppSo do bloco 2 ou no retorno via bloco 12 da 
opgao feita no 6, o jogador mantiver a tecla pressionada, o programa entrard 
nestel"loop", e ficara nele atd o jogador liberar a tecla. 

A seguir tem-se um novo lapo ou "loop" percorrendo as 36 oppoes do 
grupo 1, passando por uma varredura do tecladb. A varredura esta no endere- 
po 4250 , e as instrupoes Call KScan — Inc L — JRZ (CD BB02 — 2C — 28 
EF), garantem que enquanto uma tecla nao for pressionada o sistema perma- 
nece no "loop". 

As instrupoes Push DE antes do KScan e a Pop DE apos sao indispen- 
saveis pelo que dissemos anteriormente: o KScan altera os valores de todos 
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registradores e o DE deve ser preservado, jd que nele estd armazenado um 
enderepo entre os 36 do grupo 1, que representard o sorteio feito. 

A forma de percorrer as 36 alternativas d a seguinte: de im'cio carrega- 
se DE com o ultimo dos 36 enderepos (LD DE, 40A5), e vai-se a cada ciclo 
diminuindo-o de uma unidade (Dec DE) e somando-o a BF 7D (LD HL, 
BF 7D, ADD HL, DE). Ora, so nao ocorrera o "carry" quando DE for igual a 
4082, que d justamente a primeira das 36 possibilidades, situapSo em que o 
JRNC faz carregar de novo em DE o 40A5. 

Para que o jogo seja "honesto" e preciso que nossos dados eletronicos 
nao sejam viciados. Teoricamente teri'amos um vi'cio ao substituir o lance de 
dados pelo sorteio dentro de uma sequencia de 36 valores fixos. 0 que esta- 
mos fazendo eletronicamente equivale a ter 36 resultados colocados na peri- 
feria de um disco que gira frente a uma seta indicadora; ao parar o disco o 
resultado sob a seta e o escolhido. 

£ facil perceber que, teoricamente, a sequencia em que os valores sao 
colocados, e o ponto que estd sob a seta ao se iniciar a rotagao do disco tdm 
influencia no resultado do sorteio. Porem a velocidade de rotapao do disco d 
extremamente alta. Por menor que seja o intervalo entre duas pressionadas 
do teclado feito pelo jogador, o numero de voltas serd ainda suficientemente 
grande para poder-se com tranqiiilidade desprezar este vi'cio. 

Agora, e indispensavel que o tempo que se permanepa em cada oppao, 
bem como aquele necessario para se passar de uma para a'seguinte sejam ri- 
gorosamente igual para as 36 posipoes. A logica e as instrupoes envolvidas 
para o percurso de 35 delas, sejam de 40A5 a 4083, sao exatamente as mes- 

llustrando isso melhor tem-se, para as 35 primeiras a sequencia 

LDHL, BF7D - ADD HL, DE (o resultado d "nao carry") — JRNC — 

DEC DE — Varredura 
E para a tiltima 

LD HL, BF7D - ADD HL, DE (o resultado d "carry") - JRNC - LD 

DE, 40A5 — JR — Varredura 

Em todo computador existe um "clock" (reldgio), que nada mais d que 
um circuito oscilante, que vai emitindo impulsos eldtricos ritmados, cada um 
dos quais d chamado de "clock cycle" (ciclo do reldgio). Nos equipamentos 
comuns da linha Sinclair, este reldgio tern 3,25 MHz, ou 3,25 milhoes de ci- 
clos por segundo. Cada instrupao requer um certo ntlmero de ciclos para ser 
executada. Repetindo, nao tempo, mas sim ciclos. Entao um computador d 
tanto mais rdpido quanto maior for o numero de ciclos que seu reldgio exe- 
cutar por segundo. 
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Existe na literatura a informapSo de quantos ciclos leva cada instrupao. Pes- 
quisando-a encontrou-se para a primeira seqiiencia. 

INSTRUQAO N9DE CICLOS 

LDHL, BF7D 10 

ADD HL, DE 11 

JR NC 7 

DEC DE 6 


TOTAL 

e para a segunda 

IIMSTRUgAO 
LD HL, BF 7 D 
ADD HL, DE 
JRNC 

LD DE, 40 A5 
JR 
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N9DE CICLOS 
10 
11 
12 
10 
12 


TOTAL 55 

Ora, existe uma diferenpa de 21 ciclos, e este e um vi'cio que precisa ser 
eliminado. Para isso, incluiu-se na primeira seqiiencia um Push BC seguido de 
um Pop BC que, sem alterar nada na logica do sistema, ocupam 11 e 10 ciclos 
respectivamente, compensando os 21 da diferenpa. 

Outro detalhe a observar 6 o ndmero de ciclos associadosiasiinstrupoes 
condicionais — conforme o resultado da condipao varia o numero de ciclos 
necessarios para a sua execupao. Iz o que esta ocorrendo no caso em ques- 
tao, com a instrupao JRNC — quando ocorre o "carry" nao 6 necessario dar 
o salto ("Jump") e a instrupSo gasta 7 ciclos, e quando nao ocorre o "carry" 
o salto deve ser feito, e o numero de ciclos associado passa a 12. 



Grupo 8 - 16983 a 17103 (4257 a 42CF) 
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Apesar de extenso este grupo nao apresenta dificuldades. Ele correspon- 
de aos blocos 7 e 8 da figura 5. 

De irucio carrega-se no acumulador o valor existente no enderego indi- 
cado por DE, proveniente do bloco anterior. Atravds do AND OF e AND FO 
- RRA - RRA - RRA — RRA identifica-se os numeros originalmente ar- 
mazenados naquele enderego. 

A sub-rotina chamada, do enderego 17014 (4276 em hexa) se encarrega 
de desenhar cada um dos dados em sua vez. A logica usada e de facill com- 
preensao, lembrando apenas que a tela segue o conceito de maquina com ca- 
pacidade menor que 3,5 Kbytes. 

Finalmente, nas duas ultimas instrugoes deste grupo, d obtido no acu¬ 
mulador a s'oma dos dados que d em seguida armazenado no registrador C. 
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Grupo 9 - 17104 a 17135 (42DO e 42EF em hexa) 



Os blocos da figura 5 associados a este grupo sao os de numeros 9, 10 e 
11.0 que existe de interessante nele do uso de informagoes escritas natela 
como parte dos dados de programagao. Isto e dito porque o valor do "pon- 
to" estd registrado no arquivo da tela e na forma decimal. 

Para operar com este registro improvisado, o "ponto", de infcio acha-se 
sua localizagao (LD LH, (DFjle) — LD DE, 34 — ADD HL, DE) e verifica-se 
se hd algo registrado (AND A — JRZ). Havendo, s6 pode ser o numero 1, cujo 
codigo 6 29 (ID em hexa) e que corresponde a 10. Da (a razacp de subtrair 19 
e acumular o resultado no registrador B, que havia sido previamente "zera- 
do". A mesma logica repete-se no byte seguinte, so que la podera estar qual- 
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quer si'mbolo entre 0 e 9, cujos c6digos subtrafdos de 28 resultam em seu 
valor nominal. Por exemplo, o cddigo do s/mbolo 2 6 30 (IE em hexa) do 
qual, se subtrairmos 28 (1C em hexa), resulta o valor 2. 

Assim, tendo em A o resultado registrado no "ponto", fazer as compa- 
rapoes e dar os saltos requeridos pelos blocos 10 e 11 6 bastante simples. 


Grupo 10 - 17136 a 17146 (42FO a 42FA em hexa) 



Esta e uma rotina de controle do tempo em que os dados ficam dese- 
nhados na tela, e esta associada ao bloco 12 da figura 5. A explicapao sobre a 
logica envolvida em rotinas deste tipo ja foi apresentada no capftulo anterior. 


Grupo 11 -17147 a 17182 (42FBa431E) 
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Este grupo corresponde a situapao em que o "ponto" esta vazio, e se 
relaciona com os blocos 13, 14 e 15 do djagrama da figura 5. 

De interessante cabe ressaltar apenas a forma como se registra o resulta¬ 
do dos dados no "ponto" da tela — 6 exatamente a logica ao inverso daquela 
apresentada no grupo 9. 



Grupo 12 - 17183 a 17227 (431F a 434B em hexa) 
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SUGESTfiES 



Esta e a ultima etapa. Corresponde aos blocos 16, 17 e'18 e se resume 
em compor a tela final usando rotinas e logica ja apresentadas no capi'tulo 
anterior. 

Como coment^rio final cabe alertarque o jogador, ao apertar alguma 
tecla para sorteio de novos resultados dos dados, ou seja, ao executar o pres- 
crito no bloco 6 do diagrama da figura 5, deve evitar o uso das teclas S ou N 
pois, se a opgao conduzir ao final, o programa ird com muita rapidez para o 
bloco 2, onde ou os resultados sao apagados da tela (tecla S) ou o programa 
e eliminado da memoria (tecla N). 


1 - Converter o programa apresentado de forma a aplicd-lo em computado- 

res com qualquer capacidade de RAM. 

2 - Criar telas de instrugoes para o programa apresentado. 

3 - Alterar o programa de forma que o resultado da rodada, Perdeu ou Ga- 

nhou, fique piscando na tela, ou seja, passando alternadamente o fun- 
do branco com letras pretas para fundo preto e letras brancas. 

4 - Alterar o programa de forma a "bloquear" o uso das teclas S e N quan- 

do o bloco 6 da figura 5 estiver em execupao, de modo a evitar o pro- 
blema citado no fim do capi'tulo. 



RESUMO 

Foi abordado neste capi'tulo o seguinte 

* Uso de tela em configurapao correspondente a capacidade menor que 3,5 
Kbytes 

* Variavel do Sistema - Ram Top ou RTP 

* Rotinas da Rom - RST ou JPOOOO, Impressao na tela (0808 em hexa ou 
2056 em decimal), Pesquisa do Teclado KScan (02BB em hexa ou 699 em 
decimal) 

* Resultado em HL do uso de KScan e rotinas correlatas (espera para pressio- 
nar e liberar teclas) 

Ciclos do reldgio do computador 

Forma de sorteio de um elemento numa sequencia de valores 

* Uso de valores registrados na tela na logica do programa. 
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tilizando o “Joys¬ 
tick" estaremos ob- 
viamente estudando 
jogos de apao. Para 
tanto usamos como 
exemplo ilustrativo um 
jogo onde se rebate uma 
bola. As particuiarida- 
des do gerenciamento 
da raquete sao discuti- 
das detalhada e exausti- 
vamente. 



CAPITULO 3-0 "JOYSTICK" 


Finalmente os jogos dinSmicos! E para melhor maneja-los nada mais 
indicado do que o "Joystick". Nem todos os computadores da linha Sinclair, 
existentes no mercado, vem equipados de fabrica com soquete proprio para 
receber este acessorio, o que e uma pena. 

Em essencia o "Joystick" 6 uma extensao do teclado corn, cinco posi- 
poes, quatro das quais acionadas por uma alavanca e uma por urn botao, tarn- 
bem chamado de botao de disparo. As quatro posipoes da alavanca geram si- 
nais equivalentes aos das teclas 5, 6, 7 e 8 sem o "SHIFT". A razao da escolha 
e obvia, em funpao das setas associadas a estas teclas. Ja o disparo 6 equivalen- 
te h tecla zero. 

Como consequencia 6 uma tradipao nos programas da linha Sinclair, 
com movimentapao, usar os valores 5 a 8 para gerar os deslocamentos, de 
forma a permitir o uso do Joystick, o que nao impede, Squele que nao o dis- 
ponha, de jogar utilizando as proprias teclas do teclado. 

0 jogo ilustrativo que 6 apresentado a seguir, chamado "FIebatedor", 
pode ser praticado com o "Joystick". Diferentemente dos dois anteriores, 
tanto a logica quanto o numero de passos envolvidos sao razoavelmente gran- 
des, o que o torna de compreensao mais diffcil. Apesar disto a apresentapao 
sera feita como naqueles casos, e o ideal 6 que o leitor va acompanhando e 
entendendo cada passo na medida em que digita o programa. A absorpao das 
informapoes sera desta forma mais profunda. 

Mas se houver muita dificuldade no entendimento do que o programa 
deve fazer, tem-se a alternativa de digit^-lo por inteiro, sem maiores atenpoes 
al6m dos cuidados basicos para evitar enganos, e rodd-lo. Com isso ter-se-a 
na mente a id6ia exata de como o jogo opera. Em seguida deve-se voltar a 
ler o texto, etapa por etapa. Cabe alertar sobre dois perigos - a tendincia de 
abandonar-se a tarefa ap6s ver o resultado e a impressao, is vezes falsa, de 
ter-se entendido aquilo que de fato nao se entendeu. 

Para iniciar a apresentapao do jogo tem-se na figura 7 o esbopo da tela. 

Pressionando o zero ou o disparo, surgira num dos lados, junto a uma das late¬ 
rals, uma bola que se moveri no sentido da base, numa das direpoes possn/eis. 
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FIGURA 7 


Movendo a alavanca do Joystick para a direita ou a esquerda, ou entao 
pressionando uma das teclas 5 ou 8, a raquete move-se e devera ser posicio- 
nada de forma a impedir que a bola atinja a base marcada com pequenos 
pontos. Existem tres formas da bola ser rebatida pela raquete: 

Se atingir um dos cantos da raquete ela retornara na mesma direpao em que 
vinha, porem em sentido oposto; usando a figura 7, se a bola movia-se segun- 
do c, apos tocar o canto da raquete ela passa para a. 

** Atingindo a face da raquete, com esta movendo-se no mesmo sentido que 
a bola, ela "escorregara" (deslocar-se-a uma posipao para o lado) antes de repi- 
car; assim, na figura 7, se a bola vinha segundo b, atingindo a raquete que se 
movia na direpao II, ela deslocar-se-a uma posipao para a direita e, em seguida, 
assumira o movimento na direpao a. 

*** A raquete estando parada, ou se movendo em sentido oposto ao do que 
vem a bola, esta repicara sem escorregar; usando outra vez a figura 7, se a bola 
vinha se movendo segundo c, atingindo a raquete parada ou se movendo na 
direpao II, ela passa a seguir o movimento conforme d. 

As laterals e o topo produzem um repique "normal" (sem escorrega- 
mento) na bola. Novamente, observando a figura 7, se a bola vier segundo d e 
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tocar a lateral esquerda ela passarb para a, e se tocar o topo em seguida, assu- 
mira a direpao b. 

A barreira b constitui'da por quatro camadas de 30 blocos cada: o de 
baixo com quadriculado de cbdigo 136 (ver o manual de seu equipamento), 
o imediatamente acima com o semi-quadriculado de cbdigo 10, o terceiro 
com o semi-quadriculado de cbdigo 9, e finalmente, o de cima com quadricu¬ 
lado de cbdigo 8. A bola batendo na barreira faz "desaparecer" o bloco atin- 
gido, aumenta de urn o numero de pontos conseguidos e sofre urn repique 
"normal", da forma ja explicada anteriormente. Albm disso, em funpao do 
bloco atingido, a velocidade da bola (e da raquete por consequencia) b altera- 
da: se for urn da camada de baixo, de cbdigo 136, a velocidade sera a mais bai- 
xa, que b tambbm aquela com que o jogo se inicia; se for da segunda, cbdigo 
10, a velocidade sobe um pouco; como o 9 sobe mais ainda, e finalmente, 
com o bloco de cbdigo 8 a velocidade serb maxima. 

Se os 120 blocos forem "apagados" a barreira se recornpoe, a bola desa- 
parece, a raquete volta b posipao de partida, e o jogo pode ser reiniciado com 
o botao de disparo. 

Se o jogador nao tiver habilidade suficiente para impedir que a bola atinja a 
base, perdera a mesma. A cada bola perdida a raquete b reposicionada e uma 
nova bola volta a surgir ao aperto do disparo. Obviamente a situapao da bar¬ 
reira nao e alterada nesta circunstancia. 

Apos a perda das 5 bolas o jogo chega ao fim e aparece na tela a mensa- 
gem "Novo Jogo? (S/N)". Pressionando o S o jogo reinicia e com N a memo- 
ria RAM e apagada. 


0 Basic correspondente ao jogo b o seguinte 


Isto indica que o programa b todo escrito em linguagem de maquina e 
ocupa menos que 2 Kbytes, como o CREPE do capitulo anterior. Porbm o 
Rebatedor b algo mais longo por utilizar a tela cheia, o que ocupa 792 bytes 
enquanto o Crepe so o faz parcialmente. 
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Antes de analisar o diagrama de blocos da figura 8 cabe apresentar os 
Registros Improvisados utilizados pelo programa; 


NOME ENDEREQO (HEXA — DEC.) ABREVIATURA 

Numero de bolas DFile + 6 — 

Sentido da Raquete 403C/D — 16444/5 SENT 

Contagem 403E - 16446 CONT 

Posipao 4040/1 - 16448/9 POSBOL 

Posipao da Raquete 4042/3 —.16450/1 POSRAQ 

Direpao da Bola 4044/5 - 16452/3 DIRBOL 

Velocidade 4046/7 - 16454/5 VEL 

Para o Numero de Bolas esta sendo usada a propria tela, a semelhanpa 
do feito com o Ponto do Crepe. Os demais registros foram todos colocados no 
"Buffer" da impressora. 


O Sentido da Raquete b um registro que indica se a .raquete esta sendo 
movida para a direita ou esquerda ou entao parada, e b utilizado como indi- 
cador para gerar o efeito de escorregamento lateral da bola, no repique con¬ 
tra a raquete, como foi descrito anteriormente. A indicapao b obtida copian- 
do simplesmente neste registro o conteudo do par HL logo apos a chamada 
ao KScan. 

0 registro Contagem contbm a cada momento o numero de blocos ain¬ 
da existentes na barreira. Isto b conseguido carregando-o inicialmente com o 
valor 120, e diminuindo uma unidade a cada bloco que b atingido. Sua fina- 
lidade b indicar o momento que a barreira foi totalmente apagada (CONT = 
0), quando entao o programa sera interrompido para que a barreira seja re- 
feita, e o jogo possa recomepar. Poder-se-ia pensar em utilizar os Pontos acu- 
mulados na tela para atuar como este registrador . Porbm lembrando que a 
barreira pode ser totalmente apagada vbrias vezes, a utilizapao de um registro 
especial para este controle b uma solupSo mais prbtica. 

Os registros de PosipSo, seja da Bola como da Raquete, como o prbprio 
nome diz, contbm o enderepo onde o elemento em questao se encontra. No 
caso da Raquete a referenda b sua posipao central — ela b representada por 
cinco si'mbolos graficos de cbdigo 3. 


55 



0 registro Direpao da Bola tern uma correspondence direta com as qua- 
tro setas a, b, c e d representadas na figura 7. Isto 6, nele esta registrada a di- 
regao que a bola vem se deslocando. Isto e feito da seguinte forma: sabe-se 
que se a bola segue na direpao a e encontra-se numa certa posigao, o proximo 
enderego que ela ocupara sera o da posipao atual subtraido de 32; se a direpao 
for b o proximo sera o atual aumentado de 34 e assim por diante. Em resumo 


Direpao Valor a Somar ao End atual Conteudo do DIRBOL 
a -32 FFEO 

b 34 0022 

c 32 0020 

d -34 FFDE 


Como se ve o conteudo de DIRBOL 6, em hexadecimal, exatamente 
o valor a somar ao enderego atual de forma a encontrar o proximo que a bola 
ocupara, a menos que haja algo que o impepa, como a raquete, a lateral ou o 
topo , por exemplo. 

Finalmente o registro Velocidade content o valor correspondente ao ul¬ 
timo bloco'da barreira que foi "apagado", e que devera ser decrementado ate 
atingir zero, em cada ciclo do movimento. Quanto menorforeste valor, mais 
rapidamente os eventos se sucedem e mais dinamico se torna o jogo. Os valo- 
res possfveis de VEL em hexadecimal sao 


Condipao inicial do jogo — 0500 

Bloco apagado tern codigo 136 — 0500 

Bloco apagado tern codigo 10 — 0400 

Bloco apagado tern codigo 9 — 0300 

Bloco apagado tern codigo 8 — 0150 


Conhecendo os Registros Improvisados usados 6 mais facil examinar e 
entender o diagrama de blocos da figura 8. Apos te-lo feito, e o momento de 
detalhar o programa correlacionando-o com os blocos apresentados, como ja 
foi feito nos capftulos anteriores. 
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FIGURA 8 
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Grupo 1 - 16514 a 16527 (4082 a 408F em hexa) 

Ai' esta o texto para compor a tela final: "NOVO JOGO? S/N" 


Grupo 2 - 16528 a 16541 (4090 a 409D em hexa) 



Este corresponde ao bloco 1 da figura 8, e consiste numa rotina padrao 
para gerar o espapo correspondente k tela completa, "escrevendo" na mesma 
espapos vazios. 

A rotina se inicia com um LD (IY + 22), 00'(FD362200) — ora, pela 
logica da ROM, ao colocar o Basic a disposipao do usuario, o Registro IY 6 
feito igual a 4000 em hexa. Entao IY + 22 coincide com o enderepo 4022, 
ou 16418 em decimal, que 6 o do DFSZ citado no 19 capftulo. Colocando 
zero neste enderepo as 24 linhas da tela ficam dispom'veis para o usuario, 
e pode-se "escrever" os espapos vazios em 24 x 32 = 768 posipoes ou 0300 
em hexa, que e feito pelo restante da rotina. 


Grupo 3 - 16542 a 16603 (409E a 40DB em hexa) 
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A simplicidade do exposto dispensa comentarios. £ o proprio bloco 2 
da figura 8. 



Grupo 4 - 16604 a 16655 (40DC a 410F em hexa) 
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Outro grupo bem simples. Corresponde ao bloco 3, 
barreira e carrega 120 no Registro Improvisado "Contagem' 



seja, compoe a 


Grupo 5 - 16656 a 16706 (4110 a 4142 em hexa) 
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Por que simplificar se e possi'vel complicar? Por incri'vel que parepa este 
grupo corresponde aos blocos 14, 15, 16, 17 e 18 do diagrama da figura 8. A 
ideia foi evitar o "salto enderepado" do final da rotina, C39E40,! usandoem 
seu lugar urn "salto relativo" JR, o que acabou nao sendo possi'vel pelo 
grande numero de bytes a pular. 

Isto posto, pouco resta a comentar. De infcio localiza-se o registro "N9 
de Bolas" que e DFile + 6, reduz-se de um seu conteudo e compara-se o resul- 
tado com 9C que e o zero em fundo reverso ou preto. Nao sendo igual vai-se 
para'O infcio do jogo, isto e, para o bloco 4 que vem a seguir. Em caso con- 
trario, aplica-se a mesma rotina de finalizapao ja vista anteriormente. 


Grupo 6 - 16707 a 16746 (4143 a 416A em hexa) 
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Como ja foi dito, este e o proprio bloco 4. No grupo comepa-se apagan- 
do totalmente o conteudo da linha 21, com excepao, 6 claro, dos blocosdas 
laterals. Assim qualquer vestfgio da posipao anterior da raquete, bem como da 
frase "Novo Jogo? S/N" e eliminado. 

Desenha-se entao a raquete, carrega-se o enderepo de sua posipao central 
no Registro POSRAQ - 224240 - e finalmente carrega-se 0500 no VEL. 


Grupo 7 - 16747 a 16799 (416B a 419F em hexa) 
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Aqui tem-se novidades — o sorteio da posipao inicial da bola, usando a 
variavel de Sistema Quadros ou "Frames" em ingles, de acordo com o pres- 
crito no bloco 5 da figura 8. 

A Variavel Quadros situada em 16436/7 (4034/5 em hexa) "conta" o 
numero de quadros ou impulsos de imagens enviadas a tela. £ portanto, num 
instante arbitrario, uma boa fonte para buscar urn numero ao acaso. 

Tomou-se o byte menos significativo desta variavel que 6 o primeiro, no 
enderepo 4034, consistindo num numero de 0 a 255. 

Subtrai'ndo repetidamente 6 deste valor at6 ocorrer urn "carry", chega- 
se a urn numero entre — 1 a — 6, que somado a 14 resulta finalmente num 
numero aleatorio entre 8 e 13. 

Se o numero assim conseguido for 8,10 ou 12 o programa fard com que 
a bola surja nas linhas 9, 11 ou 13 respectivamente logo ap6s a tecla 0ter 
sido pressionada, tendo a direpao b da figura 7 — em DIRBOL havera 0022. 
Se o numero for 9, 11 ou 13 a bola surgira em 10, 12 ou .14 com direpao c, 
ou seja, em DIRBOL havera 0020. 


Grupo 8 - 16800 a 16823 (41A0 a 41B7 em hexa) 
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Af estS o KScan de novo. So que verificando se atecla 0 foi pressiona- 
da, conforme prescrito no bloco 6, em caso positivo desenhando a bola na 
posigao informada anteriormente de acordo com o bloco 7. 


Grupo 9 - 16824 a 16837 (41B8 a 41C5 em hexa) 



Esta'g'fupo corresponde aos blocos 8 e 8 da figura 8. Quanto ao primei- 
ro, nada importante a comentar. Ja no bloco 9 cabe observar que, atraves do 
incremento de B e o teste do bit 0 ser Olou 1, se consegue que a raquete tenha 
o dobro da velocidade da bola. Isto porque se Bit 0, B,= 0 ap6s passar por 
algum dos blocos alternatives chega-se ao 26, que permite mover a raquete. 
Num instante imediatamente posterior, B 4 incrementado. Bit 0, B sera 1 e o 
caminho e direto para o 26 novamente. Isto significa dois impulsos para o 
bloco 26 para cada um que vai mover a bola. 

Isto 6 indispensavel para permitir ao jogador acompanhar a maquina. 
Mesmo com esta "desvantagem", o desempenho da maquina 6 bastante diff- 
cil de ser seguido pelo homem. 
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Grupo 10 — 16838 a 16904 (41C6 a 4208 em hexa) 



Este consiste num. grupo de instrupoes bastante interessante. Ele esta 
envolvido com varios blocos da figura 8 e ainda faz uso do proprio estado da 
tela para decisSo dos passos a seguir. 

De irn'cio ele carrega em HL o que esta em POSBOL e coloca zero neste 
enderego, o que equivale "apagar" a bola. Somando a H L o que estS em Dl R- 
BOl chega-se ao enderego que a bola deve atingir na seqtiencia, ou seja, o que 
foi chamado de "posseg" na figura 8. Atraves da serie de instrugoes LDA, 
(HL) - AND A - JRNZ, testa-se se a posseg esta vazia, usando para isso a 
Propria tela. Cobriu-se assim os blocos 10 e 11 da figura citada. 
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Com a serie LD (HL), 34 - LD (POSBOL), HL - JP completa-se a se- 
quencia com o bloco 12 e atinge-se a 26. 

Em seguida 6 feita a verificagao se a posseg cont^m IB, 80, 08,09, en- 
fim qualquer urn dos si'mbolos graficos existentes ou possi'veis de estarem pre¬ 
serves abaixo da linha zero, em caso positivo, e feito urn salto ate a rotina cor- 
respondente ao conteudo. Note-se que no teste da raquete (figura de cddigo 
03) 6 necessario nSo s6 verificar a posseg como tamWm as vizinhas a esta po- 
sigSo - DEC HL; LD A, (HL); CP03; JPZ e em seguida INC HL; INC HL; 
LD A, (HL); CP02; JRZ. Passou-se assim pelos blocos 13, 19, 20 e 21 da figu¬ 
ra 8. 



Grupo 11 - 16905 a 16943 (4209 a 422F em hexa) 



Se a posseg nao esta vazia e ao mesmo tempo, nao cont^m nenhum dos 
elementos abaixo da linha zero, resulta que a bola vai de encontro ao topo. 

Contrariamente Ss situagoes anteriores, tem-se aqui o caso no qual va- 
rios grupos de instrugSes correspondem a urn so bloco: o 25. O grupo 11 em 
questao e urn deles. Nele tem-se a logica de mudanga de diregao da bola quan- 
do encontra urn "obstaculo horizontal", isto e, se ela vier na diregao a esta 6 
convertida na b, se vier segundo c passa a d e assim por diante. E 6 obviamen- 
te isto que deve ser feito se a posseg 6 urn elemento do topo. 

Este mesmo grupo seri "chamado" em vdrias circunst3ncias verificadas 
adiante. 



Grupo 12 - 16944 a 17007 (4230 a 426F em hexa) 
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Se a bola encontrou a barreira 6 para este grupo que se d3 o salto. A 
correspondence e com os blocos 22, 23 e 24. 

0 ajuste da velocidade (bloco 22) (§ feito atrav^s de LD DE, 0150 ou 
um dos outros tres valores seguido por LD (VEL), DE. 0 acerto de contagem 
vem a seguir e consiste numa I6gica interessante, que deve ser bem analisada, 
pelo potencial de uso que tem em muitos jogos. 

Para concluir o grupo, 6 feita a redupao na contagem, com a sequence 
LD (HL), A; LD A, (CONT); DEC A; JPZ; LD (CONT), A. 


Grupo 13 - 17008 a 17029 (4270 a 4285 em hexa) 
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Eis mais uma parcela do bloco 25. £ a logica a ser percorrida no caso 
da posseg ser a parede. 


Grupo 14 - 17030 a 17148 (4286 a 42FC em hexa) 
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Este fongo grupo de instrupoes 6 o ultimo relacionado com o bloco 25. 
Trata-se da logica no caso da posseg ser a raquete. Ela 6 longa em face 
das alternativas a considerar: 

* Se a bola vai atingir o canto da raquete, ela deve retornar de onde veio, ou 
seja, se a direpao era c passa a ser a. 

'Se a bola for atingir a face da raquete e necessdrio verificar a hipotese de 
ocorrer ou nao um "escorregamento" lateral. Porem isso so deve ser feito 
se a posipao ao lado nao for a parede. 



Grupo 15 - 17149 a 17219 (42FD a 4343 em hexa) 



Finalmente completamos o programa. Este grupo estd associado aos 
blocos 26 e 27, e inicia-se com um RUSH BC, antes do ja conhecido CALL 
KScan, a fim de preservar o valor de B que 6 usado no bloco 9. 
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Ap6s carregar HL no Registro SENT, § feito um teste com o valor de L 
somente. Se ele for FF a raquete nao e movida, se os quatro primeiros bits, 
de 0 a 3, nao corresponderem a F, a raquete e movida para esquerda e se os 
ultimos bits, de 4 a 7, nao corresponderem a F a raquete 6 movida para direi- 
ta. Como consequencia nao & somente com as teclas 5 e 8 que a raquete se 
move, isto e uma desvantagem, ou at6 defeito do sistema, pois com a tecla 
zero em especial, alem de fazer "surgir" a bola, a raquete se move para a di- 


RESUMO 

Foi abordado neste capi'tulo o seguinte: 

* Variivel do Sistema — Quadros (Frames) 

* Uso de Quadros para sorteio de posipoes na tela. 

* Utilizapao do conteudo da tela para alternativa de I6gica na programapao. 
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sugestOes 


1 _ Modificar o programa Rebatedor de forma que a raquete so' mova-se 

com o acionamento das teclas 5 e 8, e nao com qualquer outra. 

2 — Criar as tradicionais telas de apresentapao 

3 - Dar valores distintos na contagem de pontos em funpao do bloco da 

barreira que foi demolido. For exemplo, atribuir 2 pontos se um bloco 
de codigo 8 ou 9 for apagado, e somente um se for o 10 ou o 136 

4 — Criar uma premiapao ao jogador no caso dele conseguir acabar total- 

mente com a barreira, aumentando o numero de bolas disponi'veis ate 
um limite maximo de 9. 

5 - Analisar o programa e procurar entender o porque, em certas circuns- 

tancias, a raquete e "furada" pela bola. 
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MOVIMENTOS 

MULTTPLOS 




tev-A&v 



uando varias coisas se 
movem simultanea- 
mente na tela fica 
mais complicado o con- 
trole das trajetorias. Eis 
que neste capftulo dis- 
cutimos como realizar 
tal fapanha ao criar um 
jogo onde coexistem 
bombas, canhoes, avioes 
e tiros. 







CAPITULO 4 - MOVIMENTOS MULTIPLOS 


Os conceitos b^sicos envolvidos na conceppao e elaborapao de jogos no 
computador foram cobertos nos capi'tulos anteriores. Agora trata-se de ganhar 
pratica e enfatizar aspectos particulares que podem estar contidos num pro- 
grama. No exemplo a seguir ver-se-a varios objetos movimentando-se na tela 
simultaneamente. Dai' o nome do capi'tulo. 

Trata-se de um jogo que, a semelhanpa de muitos outros existentes no 
mercado, chama-se Invasores. A fim de melhor apresenta-lo cabe examinar o 
esbopo da tela que constitue a figura 9. 



FIGURA 9 


O invasor & um aviao, representado pelo asterisco e os sinais de "maior" 
e "menor", que "nasce" na tela a partir de uma das laterals, e desloca-se em 
direpao & outra. A cada instante nao ha mais que um aviao na tela. 

Cabe ao canhao destruir o aviao disparando tiros verticals. 0 canhao 
move-se para d direita e a esquerda, atravds das teclas 5 e 8 ou do “Joystick", 
e dispara com a tecla 0. Cada vez que o canhao destruir o aviSo hd um ganho 
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(je 10 pontos, por6m cada tiro disparado reduz a contagem em um ponto. 

O aviao tambem nSo e inofensivo — ele atira, segundo a diagonal, contra 
canhao. Atingindo-o e perdida uma vida. O aviao nao dispara mais de um ti¬ 
ro por vez segundo cada diagonal. Numa mesma direpao, o segundo tiro <§ 
disparado somente quando o primeiro ja "sumiu". Um detalhe: os tiros, seja 
do aviao, como do canhao, deslocam-se com o dobro da velocidade dos outros 
elementos da tela. 

Alem disso existe uma contagem do tempo remanescente, Ou seja, o 
jogo termina quando ou o tempo ou as vidas chegam a zero. A meta e fazer 
o maior numero de pontos neste intervalo de tempo. 

0 Basic associado ao programa e o seguinte. 


Como se ve o programa 6 bastante extenso, ocupando quase totalmente 
os 2 Kbytes disponfveis; daf a necessidade de economia da memoria. 

Antes de examinar o diagrama de blocos apresentado na figura 10, cabe 
definir os Registros Improvisados envolvidos: 


NOME ENDEREQO (HEXA-DEC) ABREVIATURA 

VIDAS DFile + 766 

TEMPO DFile + 778 

PONTOS DFile + 791 

Posipao Aviao 403C/D - 16444/5 POSA 

Posipao Tiro 1 Aviao 403E/F - 16446/7 POSTA1 

Posipao Tiro 2 Aviao 4040/1 - 16448/9 POSTA2 

Posipao Tiros Canhao 4042a — 16450a POSTC 

(10 tiros) 4055 - 16469 

Direpao do AviSo 4021 — 16417 DIRA 

Indicadorde Saida 4056 - 16470 IND 

Posipao Canhao 407B./C - 16507/8 POSC 
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FIGURA 10 
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Os tres primeiros sao os pr6prios campos correspondentes da tela. Os in- 
dicadores de posigao, quer do Aviao, do Canhao e dos respectivos tiros, in¬ 
formant a cada instante onde os mesmos se encontram. No caso do Aviao e 
o asterisco que serve de posicionamento, para o Canhao 6 a figura de cddigo 
128 (80 em hexa), uma das que compoe a base do mesmo. 

0 Registro Diregao do Aviao - Dl RA pode assumir apenas dois valores, 
zero ou urn, indicando movimento do Aviao indo da direita para esquerda ou 
vice-versa, respectivamente. 0 indicador de Sai'da esta fazendo as vezes do 
registro B do programa Rebatedor, apresentado no capi'tulo anterior, ou seja 
a de fazer com que os tiros se movam duas vezes mais rapidamente que o 
aviao e o canhao, e assume tambem somente dois valores - zero ou urn. 

Agora deve-se examinar e entender o diagrama de blocos. Urn dos pon- 
tos a realgar e justamente a forma como funciona o IND. Na sequencia dos 
blocos, chegando ao 5, IND e feito igual a zero. Ao atingir o 25, passando 
portanto por 17 e 22, sendo zero, a sequencia e o 26 onde IND torna-se urn e 
e aberta a possibilidade de mover-se o canhao. 0 retorno e para o bloco 16, 
passando novamente pelos blocos 17 e 22 onde os tiros sSo movimentados 
novamente, e daf, em 25 6 fechado o ciclo, pois como IND = 1 a sequencia 
sera o retorno ao 5. 

Outro ponto a destacar e o efeito claro/escuro, tambem chamado 
"BUM", utilizado nos blocos 19 e 23, Trata-se de uma sub-rotina que 6 "cha- 
mada" nos dois blocos citados, e que faz a inversao da tela toda, de fundo 
claro em escuro e vice-versa, por tres vezes. 

A proxima etapa 6 analisar os grupos com as instrugoes em linguagem 
de maquina. 


Grupo 1 - 16514 a 16545 (4082 a 40A1 em hexa) 

Aquj estao somente os dados para compor a tela inicial, o "rodape" da 
figura 9. 
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Grupo 2 - 16546 a 16560 (40A2 a 40B0 em hexa) 



Eis a mesma rotina de "encher" a tela para o caso de micros com RAM 
menor que 3,5 Kbytes. 



Grupo 3 - 16561 a 16603 (40B1 a 40DB em hexa) 



Neste estd a logica necessdria para compor a tela, usando entre outras 
figuras, os dizeres do grupo 1. A conjunpao dos 3 grupos vai constituir-se no 
bioco 1 da figura 10. 



Grupo 4 - 16604 a 16630 (40DC a 40F6 em hexa) 



Nada al6m do bioco 2. Sem mais comentdrios. 



Grupo 5 - 16631 a 16636 (40F7 a 40FC em hexa) 


40F7 CD BB 0£ CALL KSCfiN 
4-0FR 2C INC L 

40FB 28 Fh JR Z.4-0F7 
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£ o bloco 3. Tambem sem comentarios. 


Grupo 6 - 16637 a 16669 (40FD a 41 ID em hexa) 



Neste grupo, que corresponde ao bloco 4, 6 utilizada a mesma t^cnica 
de sorteio j^'apresentada anteriormente. 



Grupo 7 - 16670 a 16797 (41 IE a 419D em hexa) 
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Este 6 um grupo bastante longo, o que tem sua razao de ser, ja que 
ele esta associado aos blocos 5, 6, 7, 8, 9 e 10. O bloco 5 e constitufdo apenas 
pelas duas primeiras instrupoes. Ja as demais estao entrelapadas, e por sua rela- 
tiva simplicidade, foram analisadas como um so grupo. 

Um fato .a observar 6 a duplicapao das instrupoes necessarias em funpao 
do Aviao estar se deslocando para & esquerda ou a direita. Assim a\6 4166 a 
logica se aplicaria para a ultima hipotese, e a partir daf para a primeira. 
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Grupo 8 - 16798 a 16827 (419E a 41BB em hexa) 



Este grupo corresponde a uma rotina muito util, que pode vir a ser usa- 
da em outros jogos. Trata-se do controle do tempo restante na tela, dos blo¬ 
cos 11 e 12, que se inicia de um numero qualquer, no caso 1000, e termina 
com zeros, na mesma quantidade que o numero de casas do numero inicial. 
A mesma rotina poderia ser usada se o numero inicial fosse 2000 por exem- 
plo, porem se fosse 30.000, deverfamos mudar a instrupao LD B, 04 do en- 
derepo 41A9 para LD B, 05. Pelo potencial de uso futuro vale a pena saber 
o porque, e entender o conjunto. 


Grupo 9 - 16828 a 16917 (41BC a 4215 em hexa) 
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Eis outro grupo bastante longo. Como o 7 ele repete a mesma logica 
duas vezes, em funpao do Aviao estar movendo-se para & direita ou a esquer- 
e esta associado aos blocos 13,14 e 15. 

Como comentirio merece destaque a forma usada para determinar se o 
canhao esta "enquadrado" na mira, atravis do exame de todas as posipoes 
da tela, ao longo de uma reta a 45° partindo do aviao. 

Isto 6 feito usando os Registros POSTA1 e POSTA2 que, se estiverem 
"ocupados" (com conteudo diferente de zero), nao seriam usados. Este cui- 
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dado garante que nao se tenha mais de urn tiro em cada direpao, e que urn 
segundo parta apenas quando o primeiro ja "sumiu". 



Grupo 10 - 16918 a 16925 (4216 a 421D em hexa) 



Nada alem da ja conhecida rotina de consumo de tempo, que neste caso 
corresponde ao bloco 16. 



Grupo 11 - 16926 a 16997 (421E a 4265 em hexa) 
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Novamente a duplicidade, em funpao agora de haver 2 tiros possfveis do 
Aviao, o registrado no P0STA1 e outro no POSTA2. Associado a este estao 
os blocos 17 e 18. 

Cabe notar, que se na proxima posipao do tiro houver a base (figura co- 
digo 10) ou a lateral (figura codigo 8) ele some, e no POSTA correspondente 
carrega-se zero. 


Grupo 12 - 16998 a 17036 (4266 a 428C em hexa) 



Este esta associado aos blocos 19 e 20. De infcio hd uma chamada 
(CALL) a sub-rotina ja citada, de nome 'BUM", no enderepo'17153 (4301 em 
hexa) que sera vista adiante em conexao com o bloco 24. O resto, "apagar" 
o canhao, reduzir o numero de vidas na tela, e ver se chegou a zero, nao me- 
rece maiores comentarios. 


Grupo 13 - 17037 a 17086 (428D a 42BE em hexa) 
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Trata-se de um grupo bastante simples, ligado aos blocos 21 e 22, ape- 
sar de movimentar os 10 tiros possfveis de existir na tela, partidos do Canhao. 
A facilidade decorre do fato dos tiros serem verticais, e qualquer coisa que 
esteja na frente de um deles, nao sendo o topo (figura codigo 9), ou um outro 
tiro (necessariamente disparado pelo aviao), tera que ser o proprio Aviao. Se 
for o topo, apaga-se o tiro em questao e zera-se o POSTC correspondente, 
abrindo registro ou espaijo para um novo disparo do Canhao. 



Grupo 14 - 17087 a 17096 (42BF a 42C8 em hexa) 
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Eis mais um que pela simplicidade, nao cabe comentar. £ apenas o gru¬ 
po relacionado com o bloco 23. 


Grupo 15 - 17097 a 17249 (42C9 a 4361 em hexa) 
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Este 6 outro dos tais, do qual pode ser dito — "porque simplificar se 6 
possfvel Complicar", ja que, estando ligado aos blocos 24 e 25, foi montado 
em ordeni totalmente inversa a destes. Alem disso ele faz mais fungoes do 
que as discriminadas pelos blocos. Cabe entao desmembrar o grupo em sub- 
grupos. 

0 primeiro sub-grupo, do 42CS a 42E3, inicia chamando a sub-rotina 
"BUM", e aumenta de 10 a contagem da tela. A logica desta contagem d di- 
ferente da usada no capCtuio 3, e merece ser estudada e entendida perfeita- 
mente, j3 que podera ser usada em outros jogos. 0 que ela tern de caracterfsti- 
co e partir de quatro zeros, e prever um retorno ao basic, ou seja, urn final, 
caso a contagem supere o valor 9999. Isto 6 conseguido atrav^s dos sucessi- 
vos "vai-um", se for encontrada lima casa vazia; este fato 6 verificado pela 
sequencia LD A, (HL) — AND A — RET Z. Como pela caracterfstica do jogo 
esta contagem e praticamente inatingfvel, nao foi incluida a alternativa no 
diagrama de blocos. 

0 segundo sub-grupo 6 o da sub-rotina "BUM", nao localizada imediata- 
mente apos o primeiro, mas sim entre os enderegos '4301 a 4315 j inclusive. 
Ele e iniciado por uma serie de seis chamadas (CALL) a uma segunda sub-ro¬ 
tina, a do efeito "claro/escuro", intercaladas pela escrita e apagamento das 
letras B — U — M no local onde o tiro encontrou o seu alvo (aviao ou canhao) 
- daf o nome da sub-rotina. Na sequencia, o Aviao e os tiros sao apagados, 
inclusive os correspondentes Registros (POSA, POSTC e POSTA). Cabe notar 
que o Aviao 6 apagado quer seja ele o atingido, quer seja o Canhao. J3 este, so 
e apagado se for o atingido. 

Finalmente o terceiro sub-grupo e o intercalado entre os outros dois, 
no enderego 42E4 a 4300, e constitue a sub-rotina "claro/escuro". Esta e 
outra que pelo impacto visual que causa pode ser usada em outros programas. 
0 que ela faz e muito simples — soma 128 (80 em hexa) ao codigo de cada 
um dos si'mbolos na tela e como consequSncia, tudo que tinha fundo preto 
passa a ter fundo branco e vice-versa. Na sequencia existe um tradicional e 
conhecido programa que.consome tempo — o efeito claro/escuro deve ter 
uma velocidade de apresentagao mais lenta que a do deslocamento do aviSo. 
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Grupo 16 - 17250 a 17298 (4362 a 4391 em hexa) 



Este 6 o penultimo grupo e corresponde aos blocos 26, 27 e 28. Fazer 
IND = 1 (btoco 26) 6 extremamente simples e e atendido pelasduas primei- 
ras instrupoes do grupo. 

Ja verificar se uma ou mais teclas foram pressionadas, identificci-las em 
caso positivo ou saltar para o bloco 16 em caso contrario, 6 a tarefa das de- 
mais instrupoes. A novidade 6 aprender o que acontece em HL se, usando o 
KScan, forem pressionadas duas teclas simultaneamente. A resposta e urn 
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AND, ou seja, pressionando o 5 (seta a esquerda) e o zero (disparo) teremos 
em HL 

Devido ao 5 DF 7 

Devido ao zero FD EF 

Com ambos DF F7 AND FDEF ou DDE7 

Fazendo LD A, H - AND L resulta em A o valor C5 que foi usado na 
comparapao. Como foi visto no capi'tulo 3, esta pratica de combinar o H com 
o L tern a desvantagem que o comando nao e somente conseguido com as te¬ 
clas eleitas para tal fim. Porem a simplicidade da programapao e o uso do 
joystick compensam esta deficiencia. Recomenda-se repetir o racioci'nio a fim 
de constatar como chegou-se ao E5 associado a Direita + Disparo. 

0 resultado da comparapiao comanda chamadas as sub-rotinas de dispa¬ 
ro (4393 em hexa), esquerda (43CD) e djreita (4406). 


Grupo 17 - 17299 a 17462 (4393 a 4436 em hexa) 
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Este ultimo grupo, associado ao bloco 29, contem exatamente as tr§s 
sub-rotinas citadas, no grupo anterior. 

A primeira, entre 4393 e 43CC, resulta no Disparo do Canhao. De ini- 
cio 6 desenhado urn "tiro" na boca do Canhao. Em seguida a localizagao deste 
tiro e registrada em um dos POSTC, mais precisamente, no primeiro que for 
encontrado vago. Por fim e utilizada a mesma logica de redugao de contagem 
que foi aplicada no bloco 11 para o tempo restante de jogo desde que a con¬ 
tagem nao seja 0000. 

0 PUSH AF no infcio da sub-rotina e o POP AF no final visa preservar 
o valor de A para as comparagoes multiplas previstas no grupo anterior. 

As duas outras sub-rotinas, Esquerda (43CD a 4405) e Direita (4406 
a 4436) sao muito semelhantes entre si. De infcio 6 verificado se na diregao 
a ser movimentado o canhao existe a parede ou um tiro; nao havendo, ele 6 
movido. Se houver a parede, da-se o retornd sem movimentagao, e no caso de 
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um tiro, o enderepo de retorno 6 alterado de forma a ocorrer um salto para o 
bloco 19. Isto 6 feito atrav^s da seqiiencia LD DE, 16998 (116642 - 16998 
ou 4266 em hexa 6 o enderepo do bloco 19f- EX DE, HL - EX (S.P), HL - 
EX DE, HL — RET — com que o enderepo em SP passa a ser do bloco 19 e o 
valor de H L e preservado. 

Para finalizar, cabe alertar que existem alguns poucos bytes vagos nos 
dois ultimos sub-grupos de instrupoes, que funcionam como reserva apenas. 



RESUMO 

Foi abordado no presente capitulo o seguinte: 

* Rotinas para contagem crescente e decrescente na tela. 

* Efeito de "impacto" tipo claro/escuro. 

* Uso da rotina da ROM KScan no caso de mais de uma tecla ser pressionada 
ao mesmo tempo. 

* Movimentapao de multiplos sfmbolos na tela. 
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SUGESTOES 


1 - A semelhanpa dos programs anteriores alterar o Basic deste, e incluir di- 

zeres do tipo "Novo Jogo? (S/N)" na parcela em linguagem de maquina. 
Criar tambem telas com instrupoes. 

2 - Alterar o programa em linguagem de maquina de forma que o canhao, 

ao inves de mover-se lateralmente de uma posipao de memoria ou da 
tela ao ser comandado, que o fapa de meia posipao. A fim de melhor 
entender a sugestao deve-se observar que o canhao 6 composto do cano 
(figura codigo 5) e base (figuras 129 - 128 - 4); ao "mover-se" meio 
passo 3 direita ele passaria a ser programado por cano (figura 133) e 
base (figuras 135 — 128 — 130). Com isso seu movimento seria mais 
suave e uniforme, porem mais lento. 
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OP£OES 





P ermitir opgBes no 
correr de um jogo e 
uma maneira de tor¬ 
nado mais versatil e in- 
teressante. Uma emocio- 
nante corrida de auto- 








CAPITULO 5 — OPQOES 


A caracteri'stica dos jogos que vai ser enfocada neste capi'tulo e o ofere- 
cimento de escolha ao jogador frente a diferentes opp5es. A'existencia destas 
alternativas e um fator que torna o jogo mais atraente e sem duvida, represen- 
ta uma sofisticapao do programa. 

£ possfvel distinguir tres formas de conceppao das alternativas: 

* A primeira em que se mant6m a tela, ou apresentapao basica, e se oferece 
oppao quanto ao programa em si, o qual 6 modificado de forma a alterar o de- 
sempenho em termos de velocidade ou de dificuldade. Um'exemplo classico 
seria o jogo de xadrez, que pode ser praticado em diferentes ni'veis, desde o de 
principiante ate os mais avanpados. 

* Outra forma seria a de utilizar uma mesma rotina, fazendo variar as telas 
onde a mesma e praticada. 

* A ultima consistiria apenas na combinapao das duas anteriores. 

Em qualquer um dos casos haveria sempre uma alterapao em caracteri's- 
ticas do programa, condicionada a escolhas do jogador. As formas de imple- 
mentar as oppoes sao as mais variadas possi'veis e dependem da diferenpa entre 
elas. Assim para modificar uma velocidade pode ser suficiente alterar um nu- 
mero em um certo enderepo, algo similar ao que 6 feito com a Ramtop quan- 
do se deseja limitar a capacidade do computador. Ja em outros casos faz-se 
necessario utilizar longas rotinas distintas condicionadas a escolha feita. 

O exemplo que se segue apresenta uma oppao de m'vel de dificuldade. 
Trata-se de uma corrida que foi intitulada de "Sam's Race". Depois de ler a 
descripao e faze-lo rodar no computador, o leitor talvez verifique nao ser esta 
a primeira vez que v§ este jogo. 

O esbopo da tela correspondente 6 o apresentado na figura 11. 
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FIGURA 11 


Logo de im'cio surge a necessidade de optar: as letras A e B ficam "pis- 
cando" na tela, ou seja, cada uma alternadamente muda de fundo preto para 
branco. Pressionada uma das teclas o jogo inicia-se. Gomepam entao a surgir, 
em intervalos regulares, figuras representando os carros "inimigos", que se 
movem de encontro ao carro do jogador. 

Os carros inimigos deslocam-se segundo tr§s direpoes, representadas por 
a, b e c na figura 11. Encontrando uma lateral, a direpao e alterada de a para 
c ou vice-versa. 0 ponto de origem e a direpao inicial sao sorteadas. A diferen¬ 
pa entre os dois ni'veis a escolher, o normal e o mais difi'cil, e justamente a 
frequencia de ocorrencia das direpoes - no nfvel normal 75% dos carros 
deslocam-se segundo b e 25% conforme a ou c; no mais difi'cil ocorre o opos- 
to. 

A fim de evitar a colisao ou acidente, o jogador pode movimentar seu 
carro nos sentidos I e II. Para dar a sensapao de movimento, as laterals "mo¬ 
vem—se" tamb^m na direpao vertical, no mesmo ritmo que os carros inimi¬ 
gos. 
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A meta do jogo e conseguir "percorrer" a maior distSncia no tempo dis- 
pom'vel. Para um maior controle sobre o jogo, e possfvel alterar a velocidade 
dos carros atraves das teclas 6 (freio) ou 7’(acelerador). Como o comando 
"direita" ou "esquerda" e feito com o 5 e o 8 respectivamente, pode-se tam- 
bem utilizer o joystick. 

Ocorrendo uma colisao, a figura do carro do jogador e modificada para 
representar um vei'culo acidentado. Os demais carros sao apagados e da-se 
uma interrupgao de 10 unidades de tempo, ap6s os quais a corrida reinicia-se 
na velocidade original. 

Findo o tempo restante, ou seja, quando este chega a zero, a corrida 6 
definitivamente suspensa e aparece na tela a indicagao de "NOVA CORRIDA 
(S/N)". Com "S" ha um reim'cio e com "N" a memoria RAM 6 apagada. 

O Basic associado 6 o seguinte: 



Depreende-se daf que o programa e praticamente todo escrito em as¬ 
sembly e mais, como a tela esta integralmente ocupada (792 bytes), a capaci¬ 
dade do computador deve ser bem superior a 2 Kbytes. 

Quando da elaboragao deste programa nao houve a preocupagao de eco- 
nomizar-se memoria. E, de fato, existem claramente condigoes de alter<5-lo de 
forma a que se possa roda-lo num computador com somente 2 Kbytes de 
capacidade. Fica aqui a tarefa para aqueles que dispoe de computadores de 
menor capacidade: de converter o programa adequadamente para isso. Dois 
pontos a considerar na conversao sao: 

* A tela nao aeve ser totalmente preenchida, e sim tratada na forma peculiar 
aos computadores com capacidade menor que 3,5 Kbytes. Uma sugestao se- 
ria, observando a figura 11, a de eliminar todos os dizeres da tela a direita da 
pista de corrida, desloci-la uma coluna a esquerda (da 1 para a zero) e final- 
mente, manter o controle do tempo restante, a distancia rodada e as opgoes, 
todos na primeira e/ou segunda linha. Com isto, ao invds de 792 bytes a tela 
ocupafia algo mais que 300 bytes, economizando quase 490. Adicionalmente 
a isto, observando o grupo que 6 apresentado adiante, verifica-se ser desneces- 
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ipa 374 bytes d( 


saria a existencia do texto para compor a tela, o que ocu] 

1642 originalmente reservados. 

* So as duas medidas citadas ja reduzem a necessidade de capacidade a um nf- 
vel aceitavel para os 2Kbytes, por£m existem outros aspectos a explorar - a 
eliminagao dos varios bytes de reserva que foram mantidos ao longo do pro¬ 
grama, a simplificagao de algumas rotinas, como a de composigao da tela por 
exemplo. Com isso pode-se inclusive reformular o aspecto da tela de modo a 
torna-la mais atraente. 


O controle do jogo e baseado nos seguintes Registros Improvisados: 


NOME 

DISTANCIA RODADA 
TEMPO TELA 
Posigao Carro Jogador 
Contador de Carros 
Posigao Carro Inimigo 1 
Diregao Carro Inimigo 1 
Posigao Carro Inimigo 2 
Diregao Carro Inimigo 2 
Posigao Carro Inimigo 3 
DiregSo Carro Inimigo 3 
Velocidade Ajustavel 
Tempo Imutavel 
Indicador Posigao Jogador 
Indicador Paridade 


ENDEREQO 

DFile + 619 
D File + 718 
407B/C - 16507/8 
4021 - 16417 

403C/D - 16444/5 
403E - 16446 
403F/40— 16447/8 
4041 - 16449 

4042/3 - 16450/1 
4044 - 16452 

4045/6 - 16453/4 
4047/8 - 16455/6 
4049 - 16457 

404A - 16458 


ABREVIATURA 


POSCAR 

CONTCAR 

POSIN1 

•DIRIN1 

POSIN2 

DIRIN2 

POSIN3 

DIRIN3 

VEL 

TEMP 

INDCAR 

PARI 


Para melhor explicar a fungao dos Registros e a dinamica do sistema, foi 
feito ufn esquema ilustrativo sobre o esbogo da tela que 6 apresentado na fi¬ 
gura 12. 

Os indicadores de posigao seja do carro do jogador como dos inimigos 
(POSCAR e POSIN) dizem respeito aos pontos de referenda indicados na 
figura. 
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FIGURA 12 
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0 CONTCAR 6 registro mais importante para o comando do movimen- 
to dos carros inimigos. A cada ciclo ele decresce de uma unidade, a partir de 
nove at6 atingir zero. 0 valor 9 6 assumido apenas transitoriamente, no ins- 
tante em que e feito o sorteio da posigao inicial do carro inimigo 1 e, ainda 
no mesmo ciclo, o CONTCAR 6 alterado para 8. 

Existe uma correspondence direta entre a linha da tela em que se en- 
contra cada carro e o valor de CONTCAR. Por exemplo, se CONTCAR for 
7 o carro 1 estara em algum ponto ao longo da linha 3, o carro 2 na linha 12 
e o 3 em algum ponto da linha 21. So podem coexistir tres carros inimigos 
na tela. Quando CONTCAR 6 igual a 4 o carro 1 passa a ser o 2, e este passa 
a ser o 3. Ai' ficam somente 2 carros na tela at<§que, com CONTCAR nova- 
mente igual 8 ressurge o carro 1 e o carro 3 comega a "sumir".. 

0 DIRIN da indicagao da diregao dos carros inimigos e pode assumir 
urn entre os ja conhecidos tres valores - 33 para seguir reto, 32 para a esquer- 
da e 34 para h direita. 

Os registradores da velocidade ajustavel e do tempo imutavel terao suas 
fungoes facilmente entendidas quando for exposto o programa grupo a grupo. 


0 INDCAR registra a posigao do carro do jogador. Ele varia de zero a 
dez de forma que, no valor mais baixo, o carro encontra-se na extrema esquer- 
da, e com 10 na direita. 

Finalmente o PARI e urn indicador usado para permitir que o carro do 
jogador se mova duas vezes mais rapidamente que os inimigos, seguindo a 
mesma rotina ja usada anteriormente. 

Resta ainda apresentar, antes da analise do diagrama de blocos, as prin¬ 
cipal sub-rotinas utilizadas no programa. A maior parte delas nao 6 expres- 
samente indicada em bloco algum, mas o conhecimento de sua existence e 
das tarefas que executant serao de boa valia na compreensao geral do esque- 
ma. Sao elas: 


* Repique no enderego 17627 (44DB) responsavel em testar se o carro ini¬ 
migo esta indo de encontro a Lateral e, em caso positivo, alterar sua diregao. 

* FazCarln no enderego 17647 (44EF) cuja fungao 6 desenhar o carro inimi¬ 
go. 

* ApCar no enderego 17670 (4506) que se incumbe de "apagar" os carros, 
tanto os inimigos quanto o do jogador. 

1 TesTrom no enderego 17689 (4519) que testa se o carro inimigo esta indo 
de encontro ao carro do jogador, ocorrendo uma trombada. 

* LatSobe no enderego 17759 (455F) responsavel por mover .as laterals. 

* FazCar no enderego 17785 (4579) desenha o carro do jogador. 

* Teste no enderego 17811 (4593) verifica se ao mover-se o carro do jogador 
nao se choca com um inimigo. 

* Trombada no enderego 17835 (45AB) bastante importante pois, alem de 
desenhar o carro batido, apaga os carros inimigos da tela, zera os registros 
correspondentes e mantem o jogo suspenso por 10 unidades de tempo. 

* TemDim no enderego 17942 (4616) 6 a sub-rotina mais explicitada no dia¬ 
grama de blocos, responsavel pela redugao do tempo-tela e conseqiiente veri- 
ficagao do final, desenhando neste caso a tradicional frase "Nova Corrida? 
(S/N)". 

Posto isto cabe apresentar e analisar a figura 13, onde se encontra o dia¬ 
grama de blocos que, com tudo o que ja foi descrito, nao deve causar maiores 
dificuldades de compreensao. 

Seguindo a mesma sistematica de apresentagao dos capi'tulos anteriores 
tem-se agora os grupos de instrugoes. 
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Com este compoe-se a tela, incluindo o carro do jogador, e se estabelece 
o valor imcial do INDCAR que 6 5. Para finalizar 6 feita uma chamada ao en- 
derego 18049 (4681 em hexa) e aparecem dois bytes de reserva. 



1.11 















Grupo 3 - 18031 a 18156 (466F a 46EC em hexa) 





46HH i-E rD 
4 6 H C 28 05 
46SE FE 5F 
4 6£3 £ 8 0 C 

46B2 IS Dfl 

4 6 B 7 ED B0 
46B9 11 00 00 



Cuidado! Contrariando a forma que vinha sendo utilizada na apresenta- 
?ao, ha aqui um pulo na seqtiencia dos enderepos. Para Clareza .da explicapao 
achou-se por bem seguir este caminho. Este grupo deve ser o ultimo a ser 
digitado. Ele, em conjunto com os dois anteriores, vai constituir o bloco 1 do 
diagrama da figura 13. 

Percebe-seclaramenteque o programa, ap6s sua conceppao original, so- 
freu uma alterapao onde, entre outras coisas, foi introduzida a rotina de op- 
pao. Esta e uma forma de utilizar os bytes de reserva, quando seu numero nao 
& suficiente para conter os dados a acrescer, qual seja a de fazer um CALL 
para o fim do programaonde existe normalmente espapo em abundancia. Para 
aqueles que, por limitapao de capacidade, irao reescrever o programa, eis a 
oportunidade de economizar alguns bytes, bastando colocar este grupo em 
seqtiencia com o anterior, formando um so bloco, sem necessidade do CALL. 

0 grupo se inicia por uma sub-rotina, entre os enderepos 18031 a 18048 
(466F a 4680 em hexa), responsavel pela inversao do "fundo", usando para 
isso a tdcnica de somar 128 (80 em hexa) jci conhecida. Em complementa- 
pao existe uma rotina de consumo de tempo correspondente ao intervalo em 
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que a iintfersao persiste, para imediatamente ap6s ocorrer a reinversao. 

0 restante do grupo, a partir do enderepo 18049 (4681 em hexa), 6 
exatamente o chamado pelo CALL. Em primeiro lugar o CONTCAR e os 
demais registradores sao zerados. Isto se faz necesSdrio par.a evitar problemas 
na situapao de reim'cio do jogo, apos o termino de uma corrida. Entao se da 
o "pisca" das letras A e B com o uso da sub-rotina descrita anteriormente, e 
o teclado 6 pesquisado atravis do mais que conhecido KScan. Se A for a te- 
cla pressionada, uma s6rie de 13 bytes a partir do enderepo 17069 (42AD em 
em hexa) serao substitui'dos pelos 13 existentes a partir do 18131 (46D3 em 
hexa) e se B for a tecla, a troca serd feita pelos bytes do enderepo 18144 
(46EO em hexa). Por fim a letra correspondente a tecla pressionada se man- 
tera com o "fundo" invertido. A forma como isto esta sendo feito 6 interes- 
sante e merece alguma atenpao. 



Grupo 4 - 17013 a 17024 (4275 a 4280 em hexa) 



Nada a!6m do prescrito pelo bloco 2. Sem coment^rios. 


114 


Grupo 5 - 17025 a 17090 (4281 a 42C2 em hexa) 



£ neste grupo que 6 feita a alterapao comandada pela oppao descrita no 
grupo 3. Hd uma correspondSncia entre estegrupo e os blocos 3 e 4 da fiqura 
13. 

De ini'cio verifica-se se o CONTCAR 6 zero. Nao sendo, ha urn salto, e 
na hipdtese contr^ria, CONTCAR 6 feito igual a 9 e o sorteicr da- posipao 
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inicial do carro inimigo 1 (POSIN1) e a respectiva diregao (DIRIN1) & feito, 
S6 que este nao <§ um sorteio "honesto". Verificou-se que o jogo fica mais 
atraente se o jogador for forpado a sempre mover seu carro, fugindo do aci- 
dente. Por isso POSIN 6 determinado em fungao do INDCAR, ou seja, da 
posigao do carro do jogador. 

Para o estabelecimento do DIRIN 6 que sao feitas as alterapoes, confor- 
me oppao descritas no grupo 3 — o enderego 42AC esta ai envolvido. 0 
acumulador A 6 feito igual ao Quadros, e a ele 6 somado o conteudo de INC- 
CAR. Ap6s o AND 07, com o qual A ter<5 um valor de 0 a 7 - isto <§, 8 possi- 
bilidades - chega-se ao 42AC. Se a oppao for pelo m'vel normal, seis dos oito 
valores possi'veis de acumulador conduzirao o conteudo de Dl RIN a ser 33 
(reto), um conduzira para 34 (direita) e o outro restante para 32 (esquerda) 
ou seja, como dito, seis em oito representa 75% de possibilidade do carro se- 
guir reto. Ja se a oppao for pelo mais diffcil, faz-se a inversao das porcenta- 
gens. 

Os cinco bytes com conteudo zero que aparecem imediatamente antes 
do AND 07 sao de reserva, e podem portanto ser eliminados. A existencia des- 
tes no meio de uma rotina e mais um indfcio de programa modificado. 



Grupo 6 - 17091 a 17220 (42C3 a 4344 em hexa) 
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Este grupo e associado aos blocos 5, 6 e 7. As cinco primeiras instrugoes 
cobrem os dois primeiros blocos citados, e todo o resto & necessario para c 
ultimo bloco. 

O valor de CONTCAR vai sendo testado e, conforme seu valor, o carro 
i'nimigo 1 6 parcialmente desenhado e apagado. Gradualmente o desenho do 
carro vai se completando ate que com CONTCAR contendo um valor menor 
que 7 o carro ja <§ desenhado e apagado por inteiro. No final isto 6 feito atra- 
v6s do uso das sub-rotinas citadas ApCar, Repique e FazCarln. Alguns pode- 
rao nao entender porque ap6s o CALL FazCarln (CDEF44) existe a sequen¬ 
ce _ AND A - JRZ — LD (DIRIN1), A. 0 motivo pode ser encontrado na 
sub-rotina Repique - nela o acumulador 6 usado como indicador de sai'da: 
se ele for zero o valor de DIRIN nao deve ser alterado, e se for diferentede 
zero o DIRIN deve passar a conter o valor do acumulador. 



Grupo 7 - 17221 a 17251 (4345 a 4363 em hexa) 
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Com este, o carro inimigo 2 e apagado e redesenhado um passo adiante. 
Ha uma correspondence com os blocos 8 e 9. 



Grupo 8 - 17252 a 17302 (4364 a 4396 em hexa) 



Este 6 um grupo relativamente simples, estando relacionado com os blo¬ 
cos 10, 11, 12 e 13 da figura 13. De marcante cabe apenas assinalar que a 
verificagao de ser POSIN3 = 0 estd sendo feita pelo teste de um s6 byte, atra- 
ves do acumulador, usando a sequencia LD LH, (POSIN3) — LD A, H — AND 
A-JRZ. 
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Grupo 9 - 17303 a 17448 (4397 a 4428 em hexa) 
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Aqui comepam as trombadas. Elas se dao sempre entre o carro inimigo 
3 e o do jogador. Os blocos ligados a este grupo sao os 14, 15 e 16. As duas 
primeiras instrupoes constituem o 14 e os dois outros blocos vao sendo repe- 
tidos a cada valor de CONTCAR. De uma certa forma a rotina aqui envolvida 
6 a inversa da do grupo 6, ja que o carro vai gradualmente desaparecendo. 

O teste de trombada e feito a cada vez com o uso da sub-rotina Tes- 
Trom. 
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Gruoo 10 - 17449 a 17484 (4429 a 444C em hexa) 



Este grupo e assim curto pelo fato dele usar a sub-rotina LatSobe. Cor- 
responde ao bloco 17 da figura 13 em que, al6m de mover as laterals, a dis- 
tancia e aumentada na tela. A sistematica para este aumento ja foi apresen- 
tada anteriormente. 
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Grupo 11 - 17485 a 17505 (444D a 4461 em hexa) 



Outro grupo curto devido ao uso de sub-rotinas, a TemDim neste caso. 
0 grupo corresponde ao bloco 18. 

0 interessante nestas instrugoes 6 que se trabalha com dois registradores 
para consumo de tempo — um carregado em BC que 6 o Velocidade, e que da 
o ritmo variavel para os carros; o outro carregado em HL que 6 o Tempo Imu- 
tavel controlando o Tempo Restante da tela. 

0 ritmo do tempo da tela nao 6 exatamente constante mas, para os fins 
de um jogo, sua uniformidade 6 aceitavel. A forma de .fazer isto 6 recarregar 
no TEMP sempre um mesmo valor, 0800 em hexa no caso, toda vez que ele, 
pelas sucessivas redupoes, atingir zero. A cada ciclo se decrementa tanto o 
BC como o HL at6 que o primeiro atinja o zero; entao o valor remanescente 
em HL 6 resguardado no TEMP. 



Grupo 12 - 17506 a 17626 (4462 a 44DA em hexa) 
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Este grupo est^ ligado a todo um conjunto de blocos: 19, 20, 21, 22, 
23, 24 e 25. Assim 6 conveniente analisa-lo por sub-grupos. 

Do 4462 a 4476 6 utilizado o frequentemente citado KScan e ao sub- 
grupo correspondent blocos 19, 21 e 23. 
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O subgrupo seguinte 6 dp enderepo 4477 ao 4484 e faz exatamente o 
prescrito pelo bloco 20, ou seja, incrementa o PARI e da os saltos em funpao 
do bit zero deste registrador. 

Prosseguindo vem o 4485 a 44A5 que acelera ou breca os carros, isto 
6, 6 o associado ao bloco 22. Como observapao digna de nota 6 o fato de so 
haver limitapao na redupao da velocidade e nao no seu aumento. 

Por fim vem o ultimo sub-grupo, do 44A6 a 44DA ligado aos blocos 
24 e 25. Nele sao usadas Vcirias sub-rotinas que o simplificam, a ApCar e a 
FazCar que apaga o carro de uma posipao e o desenha na seguinte, e a Teste 
utilizada para detectar a ocorrencia de trombada. 



Grupo 13 - 17627 a 17646 (44DB a 44EE em hexa) 
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Eis a sub-rotina Repique, primeira de uma s6rie nao associada direta- 
mente a bloco algum da figura 13. Ela apenas verifica se o carro inimigo vai 
de encontro a lateral e, em caso positivo o Acumulador deixa de ser zero e 
passa a conter a diregao a seguir. 



Grupo 14 — 17647 a 17669 (44EF a 4505 em hexa) 



£ a sub-rotina FazCarln, ou seja, desenha a figura do carro inimigo. Sem 
comentarios. 
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Grupo 15 - 17670 a 17688 (4506 a 4518 em hexa) 



Outra sub-rotina que nao merece comentarios. £ a ApCar que apenas 
apaga o desenho dos carros. 


Grupo 16 - 17689 a 17758 (4519 a 455E em hexa) 
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Esta e a TesTrom, ou seja, a sub-rotina que verifica, no movimento do 
carro inimigo 3, se ele vai trombar com o carro do jogador. Nao 6 das mais 
complicadas, e merece alguma atengao para uma perfeita compreensao. 
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Outra sub-rotina bastante simples. Atrav^s desta as laterais sao movidas. 
£: a que foi chamada LatSobe. 


Grupo 18 - 17785 a 17810 (4579 a 4592 em hexa) 



Esta § a FazCar que desenha o carro do jogador. Tamb6m sem comenta- 

rios. 



Grupo 19 - 17811 a 17834 (4593 a 45AA em hexa) 
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Esta 6 a sub-rotina Teste utilizada tanto no movimento do carro inimigo 
3 como no do jogador para verificar se havera uma trombada. 


Grupo 20 - 17835 a 17941 (45AB a 4615 em hexa) 
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Aqui retorna-se ao programa basico. Este grupo esta associado aos blo- 
cos 26, 27 e 28. De ini'cio todos os carros sao totalmente apagados da pista. 
Todos os registradores de posicionamento e diregao, com excegao do POS- 
CAR, sao entao zerados. Baseado no POSCAR o desenho do carro trombado 
6 executado. 

0 efeito de consumir 10 unidades de tempo 6 implementado atravds das 
chamadas sucessivas a sub-rotina TemDim e, ao final, tem-se o carro do joga¬ 
dor redesenhado com o uso da FazCar. 

Os 16 bytes que estao no final da serie sao de reserva e poderiam ser eli- 
minados. 
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Grupo 21 - 17942 a 18030 (4616 a 466E em hexa) 
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Este 6 o ultimo grupo do programa. £ a sub-rotina TemDim que no dia- 
grama de blocos da f igura 13 corresponde aO numero 29. Apesar de sua im- 
portancia os comentarios nao se fazem necessarios ja que ela 6 composta de 
uma sequencia de instrupoes ja conhecidas e explicadas anteriormente. 



RESUMO 

Foi abordado no presente capftulo o seguinte: 

* Forma de alterar o programa pelo uso de chamada a sub-rotina. 

* Convenience e modo de fazer um sorteio orientado. 

* Tdcnica para manter concomitantemente dois ritmos distintos, no caso a re- 
dupao uniforme do tempo na tela e o movimento variado dos carros. 

sugestQes 

1 — Introduzir no programa uma rotina que, ao fim de cada partida, compa¬ 

re a distancia rodada com um valor anteriormente conseguido, e regis- 
tre o maior deles como "Record do Dia". Sendo mais exph'cito — eli- 
minar da tela a frase "tempo 6 perdido em cada acidente" e em seu lu- 
gar criar um registro "Record do Dia" contendo o valor da distancia 
conseguido em partidas anteriores e que servir3 para comparapao com o 
valor da distancia rodada conseguida na ultima jogada. 

2 — Este jogo foi desenvolvido basicamente pensando no uso do joystick e 

assim nao foi prevista a possibilidade do jogador apertar duas teclas si- 
multaneamente, ou seja, o comando de deslocar o carro a direita e ace- 
lerar ao mesmo tempo, por exemplo. Introduzir estas alternatives no 
programa. 
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REQUINTES 

© 




R equintes e sofistica- 
pao dao o verdadeira- 
mente feliz acaba- 
mento a um jogo que se 
preze. Paradoxalmente 
aqui se discutem os re¬ 
quintes com um provin- 
ciano "Fuscao Preto". 
0 festival de estranhos 
SCROLLS e apresenta- 
qoes do jogo sao aqui 
discutidos em todos 
seus detalhes t^cnicos. 



CAP ITU LO 6 - REQUINTES 


Enfim chegou-se ao ultimo capftulo. Isto nao significa que o assunto, 
programagao de jogos em linguagem de maquina para computadores da li- 
nha Sinclair, tenha se esgotado. Nem era essa a intenpao do livro. Pretendeu- 
se, isto sim, dar uma visao geral e alguns exemplos prdticos e claros relativos 
ao tema, o que se espera ter alcangado. E para finalizar, o enfoque dado nos 
requintes. 

Entende-se por requintes, os detalhes e caracteristicas nao essenciais pa¬ 
ra o funcionamento do programa, visando melhorar o visual ou a sua apresen- 
tapao. Nesta ordem de id^ias, v<§rios requintes ja foram sugeridos em capi'tu- 
los anteriores: criar telas com instrupoes, premiar o jogador caso atinja urn 
certo desempenho, apresentar ao final da partida o registro do recorde do 
dia, etc. Destes, sem duvida, as telas com instrupoes sao os mais uteis; com 
elas, gastando apenas poucos metros a mais de fita, evita-se a necessidade de 
instrupoes escritas em papel que nem sempre sao achados quando e necessci- 
rio. 0 problema e que a capacidade de memoria do equipamento pode nao 
ser suficiente para conter o programa e as telas em questao. Cada uma destas 


ocupa quase 800 bytes e, em geral, content tao poucas informapoes.. 


_EU££ AQZEBEfl UZZZZZZilZLl 

^IISkrMESEjDEZUMArqORRTDA^nBl 

deCpjlsiiaZ T1—r TT ——I t uya ~ 




K R FaI| ~0U£Z^n^^l V§M" 


FIGURA 14 
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Para ilustrar este capftulo escolheu-se urn jogo, denominado "Fuscao 
Preto", que tern uma apresentagao bastante requintada. Infelizmente para 
aqueles possuidores de equipamentos com capacidade de 2 Kbytes, o progra¬ 
ma em si, mesmo sem as instrupoes, ocupa mais do que isso. 

Logo apos carregar o programa aparece uma tela com instrupoes, cujo 
esbopo 6 dado na figura 14. 

Pressionando a tecla S vai havendo urn efeito de Scroll, ou seja, as pri- 
meiras linhas vao sumindo no topo e novas linhas surgem na base, at6 che- 
gar-se ao final, conforme ilustrado na figura 15. 



Caso queiramos reler alguma instrupao, basta pressionar Deo efeito se 
inverte, ou seja, as ultimas linhas vao desaparecendo na base e novas aparecem 
no topo, gerando o que pode ser chamado de antiscroll. 

Pressionando a tecla C, a tela altera-se ficando como o esbopo da figura 

16. 
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0 basic associado' ao programa 6 o seguinte: 



Acionando qualquer tecla a figura "0" e o asterisco de fundo escuro co- 
mepam a mover-se em sentidos contrarios — o "0" para cima (sentido hora- 
rio) e o asterisco para baixo (sentido anti horario). 

Ao mover-se, o "O" vai fazendo sumir os pontinhos e a cada um deles 
os Pontos da tela sao incrementados. A passagem do asterisco nao afeta o 
conteudo da posipao da tela. 

Se a tecla zero, ou botao de disparo for acionada, o asterisco tem sua 
velocidade reduzida pela metade, o que equivale ao "0" avanpar em relapao 
a ele. A cada posipao que o "O" se adiante, uma unidade e reduzida do 
Bonus. 

Se o asterisco se "chocar" com o "O" uma vida e perdida, como ja foi 
descrito nas figuras 14 e 15. Para evitar isto o "0" passando em frente as 
aberturas pode mudar de pista, desde que a alavanca do joystick ou as teclas 
5 e 8 tenham sido acionadas adequadamente (as teclas 5 e 8 nas pistas verti¬ 
cals, a direita ou esquerda, e as 6 e 7 nas horizontais, em cima e em baixo). 
0 asterisco 6 programado de forma a orientar seu movimento conforme o 
de "O", e assim aquele tambem mudara de pista se este o fizer. Dai' a impor- 
tancia ou a maior facilidade de fuga se o avanpo de "0" tiver sido feito 
previamente. 



Isto <§, em sua forma completa o programa utiliza mais de 4 Kbytes de 
memoria e mesmo se somente as rotinas do jogo em si fossem consideradas, 
a capacidade necessdria seria proxima dos 3 Kbytes. 

Os Registros Improvisados criados sao: 


NOME 


ENDEREQO (HEXA-DEC) ABREVIATURA 


Pontos Tela 
Bonus Tela 
Vidas 

Pista do "O" 

Bonus 

Contagem 

Velocidade 

Acelerador 

Posipao do Asteriscd 

Pista do Asterisco 

Direpao do Asterisco 

Conteudo da Posipao do 

Asterisco 

Direpao de "O" 


D File + 349 
D File + 413 
DFile + 478 
4021 - 16417 

407B -16507 

407C - 16508 

403C/D - 16444/5 

403E - 16446 

403F/40— 16447/8 

4041 - 16449 

4042 - 16450 

4043 - 16451 

4044 - 16452 


PI ST AO 
BONUS 
CONT 
VELOC 
ACEL 
POSAST 
PI ST AST 
DIR AST 

CONPOAST 

DIRO 


Os tres primeiros registros sao auto explicativos. 

O registro Pista do "0" informa a cada instante em qual pista o "0" se 
encontra, e e utilizado primordialmente no movimento do asterisco para de- 
terminar se ele deve ou nao mudar de pista. 0 conteudo deste registro 6 um 
numero de 1 a 4 em conformidade com aquele associado as pistas. 

A pista 16a mais externa (mais comprida) e a 4 6 a interna (mais curta) 
que contorna o centro; a 2 e 3 sao as intermediaries. 
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O registro Bonus corresponde exatamente ao Bonus da tela e seu uso 
justifica-se apenas para simplificar a logica de acelerar, (se Bonus = 0 nao se 
pode acelerar) e ao final do jogo, para somar os valores remanescentes aos 
Pontos Tela. Em suma, seu conteudo 6 urn numero de 0 a 40. 

0 registro Contagem cont^m um numero de 0 a 239, e serve para con- 
trolar os pontinhos ainda existentes na tela. A cada um que 6 apagado o valor 
do registro 6 decrementado. 

0 registro Velocidade controla a velocidade do jogo como o prdprio no- 
me diz. Ou seja, a cada vez que o tempo e consumido para uma espera no 
jogo, 6 o valor contido neste registro que 6 transferido para um dos pares 
RL, DE ou BC para ser decrementado at6 zero. Cada vez que os pontinhos 
sao totalmente apagados, o valor deste registro 6 diminufdo para aumentar 
a velocidade. 

0! Acelerador! e um registro que funciona como indicador para saber 
se no ciclo imediatamente anterior o Asterisco foi retardado ou nao, de forma 
a garantir que a velocidade deste nao fique inferior a metade da do "O". 

Seu funcionamento 6 similar ao PARI do Sam's Race (capi'tulo 5) ou 
IND dos Invasores (capftulo 4). 

O POSAST 6 um classico registro de posipao do Asterisco. O PISTAST 
6 o equivalente ao PISTAO. 

O registro DIRAST 6 algo mais c.omplicado. Pode assumir um valor de 1 
a 12. Quando o Asterisco esta "descendo" pelo lado esquerdo da tela, ele po¬ 
de ter um entre tres valores: 1 se descer direto, 2 se estiver passando ;de uma 
pista para outra de numero mais baixo (de 3 para 2 por exemplo) e 3 se for 
de uma pista mais baixa para mais alta (de 3 para 4 por exemplo). Em'resu¬ 
mo temos: 


VALOR DE DIRAST 

DIREQAO DO ASTERISCO DIRETO AUMENTA DIMINUI 

Lado Esquerdo — descendo 1 3 2 

Embaixo - da esquerda para direita 4 5 6 

Direita — subindo 7 8 9 

Em cima - da direita para esquerda 10 11 12 

NOTA: a inversao entre 3 e 2 foi acidental e resolveu-se nao alterar o progra- 
ma somente por isso. 
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FIGURA 17 
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0 CONPOAST informa o conteudo que havia na posipao da tela em que 
o Asterisco esta sendo desenhado de forma que, ao mudar de posipao no pr6- 
ximo ciclo, se possa redesenhar o conteudo anterior sem altera-lo. Assim o 
registro pode conter 00 (vazio), IB (pontinho) e 34 (figura "0"). O ultimo 
caso indica que uma vida sera perdida. 

Por ultimo tem-se o DIRO. Este registro e previsto para conter apenas 
dois valores, ou 01 ou FF. 0 motivo de sua existencia 6 que o movimento de 
“0" e governado por duas sub-rotinas - uma para quando ele sobe ou desce 
(lado esquerdo ou direito da tela) e outra para quando ele se move horizon- 
talmente (da direita para esquerda ou vice-versa). Para distinguir as alternati¬ 
ves DIRO 6 01, quando “0" sobe ou vai da esquerda para direita e e FF quan¬ 
do desce ou vai da direita para esquerda. 

Isto posto veja agora o diagrama de blocos que 6 apresentado na figura 
17. 


Logo no im'cio pode-se observar que o diagrama nao e muito complica- 
do, o que, a primeira vista, nao justifica os mais de 2 Kbytes necessarios para 
traduzi-los em linguagem de maquina. 

0 motivo e que, a menos dos blocos de inicializapao e finalizapao e de 
algumas sub-rotinas comuns, o diagrama que 6 apresentado refere-se a apenas 
uma das direpoes do movimento de "0", o de subida do lado esquerdo por 
exemplo. Em termos de logica ha uma repetipao nas quatro direpoes, pordm 
em termos de programa, na conceppao em que foi feito, ha diferenpas que 
implicam em ter que escreve-lo quatro vezes. A sai'da de uma direpao se d A 
no bloco 6, e a entrada no grupo de instrupoes da outra direpao se da no pon- 
to de acesso ao bloco 9. 

Conhecendo os Registros Improvisados e os comentarios apresentados 
nao haver4 dificuldade no entendimento do diagrama da figura 17. Pode-se 
entao partir para o exame dos grupos de instrupao em linguagem de maquina. 

Grupo 1 - 16514 a 17066 (4082 a 42AA em hexa) 
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IJO iJi ID CTi ID ID ID ID ID Iji 'J- 11 ' 
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Faz exatamente o prescrito pelo bloco 2 da figura 17 — Sem coment^- 

rios. 



0 unico detalhe a citar 6 o fato de que o enderego onde o "0" se en- 
contra <§ acumulado no stack, atrav<§s da instrugao PUSH HL, imediatamente 
antes do conhecido Call KScan, que constitue o bloco 4 da figura 17. As 
instrugoes anteriores estao ligadas ao bloco 3. 



Grupo 4 - 17239 a 17276 (4357 a 437C em hexa) 
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As seis primeiras instrupoes do grupo constituem-se numa sub-rotina de 
consumo de tempo baseada no Registro VELOC. que serd "chamada" diver- 
sas vezes ao longo do programa. A primeira destas ocorre imediatamente em 
seguida, e considerando as duas posteriores (POR HL — LD (HL), 00) tem-se 
atendido o bloco 5. 

As instrupoes seguintes estao associadas ao bloco 6, por6m na condigao 
de “0" e^tar subindo. Isto £ facilmente notado pelo fato da POSSEG (Posi- 
pao Seguinte) ser obtida da anterior subtrai'da de 33 em decimals. Feito o 
teste se a posipao seguinte e a parede, o salto relativo leva o programa para o 
grupo onde o "0" se movimenta a direita. A razao de testar duas posipoes a 
frente (atraves do uso do registro C) deve-se a uma alternativa que existia e 
foi eliminada do programa. 

Ao fim deste grupo existe uma chamada a uma sub-rotina. Esta vai se 
constituir nos blocos 7 e 8. 



Grupo 5 - 17277 a 17334 (437D a 43B6 em hexa) 
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Se "0" viesse pelo ramo de baixo, da direita para esquerda, seria neste 
ponto que ele entraria no programa do movimento de subida. Por isso o grupo 
inicia-se acertando o DIRO, e carregando DE com 33 em decimal. Isto £ o 
bloco 9. 

Em seguida tem-se o bloco 10, com as instrupoes de CP IB e a corres- 
pondente chamada a sub-rotina, que ira constituir os blocos 11 e 12. Na se¬ 
quence o CP97 e o salto condicionado a zero constitue o bloco 14, sendo 
que o enderepo do salto leva para onde estao as instrupoes dos blocos 25, 26 
e 27. 

A proxima etapa e fazer um PUSH H L que sera explicado adiante, e de- 
senha-se o "0", isto e, atingimos o bloco 15. As instrupoes do bloco 16 £ que 
surgem a seguir e ai, se ACEL nao for zero da-se um salto para o bloco 5, ou 
seja, grupo 4 onde o enderepo do "0" £ obtido pelo POP. Eis a razao do 
PUSH, que e ainda reforpada pelo detalhe de que ao fazer a chamada a sub- 
rotina do bloco 17, objeto da proxima instrupao, havera uma consulta ao te- 
clado (Call KScan), e caso o jogador tenha acelerado, o salto para a mesma 
posipao citada acima, do bloco 5 grupo 4, ocorrera. 

O final do grupo corresponde a uma chamada a sub-rotina que coman- 
da o movimento do Asterisco, englobando os blocos 19, 20, 21, 22 e 23. A 
verificapao do CONPOAST, objeto do bloco 24, e ainda parte deste grupo, 
que acaba com um salto ao conjunto dos blocos 25, 26 e 27 caso haja la o 
34. Em caso contrario novamente, se atingirS o bloco 5 do grupo 4. 



Grupo 6 - 17335 a 17405 (43B7 a 43FD em hexa) 
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Esta 6 exatamente a repetipao dos grupos 4 e 5 por£m aplicada ao ra- 
mo de cima, ou seja, naquele em que o "O" se destoca da esquerda para a di- 
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Grupo 7 - 17406 a 17490 (43FE a 4452 em hexa) 



Nova repetigao dos grupos 4 e 5, agora aplicado ao ramo da direita em 
que o "0" desce. 


157 















Ultima repetigao dos grupos 4 e 5, para o caso em que o "0" se deslo- 
ca pelo ramo de baixo, da cireita para esquerda. 

Observando os grupos 4 e 8 constata-se que realmente seria possi'vel 
economizar bytes, aproveitando conjunto de instrugoes identicos compondo 
sub-rotinas. No entando a economia, al6m de nao ser grande, tornaria mais 
complexa a compreensao e elaboragao do trabalho. 



Grupo 9 - 17563 a 17667 (449B a 4503 em hexa) 
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Esta d a sub-rotina correspondente aos blocos 7 e 8 que havia sido cita- 
da no grupo 4. Como comentado na explicagao do Registro DIRO, este con- 
junto de instrugoes aplica-se para os ramos verticals, da esqeerda em que "0" 
sobe e da direita em que ele desce. 
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Analisando as instrugoes constata-se que, de im'cio, o teclado d pesqui- 
sado pelo KScan e caso as teclas 5 ou 8 estejam sendo pressionadas dd-se urn 
salto para urn grupo de instrugoes correspondentes a cada tecla, e-em caso 
contrario ocorre o retorno a chamada, 

Apos o salto, nos blocos correspondentes a cada tecla deteeta-se se exis- 
te a possibilidade de mudar-se de pista, isto d, se na diregao que "O" deve mo- 
ver-se nao existe a parede (figura de codigo 08). Se a parede Id estiver nova- 
mente, da-se o retorno. 

Em seguida e feita a alteragao da pista, atraves da sdrie LD A, (DIRO) 
- LD B, A — LD A, (PISTAO) — SUB A, B — LD (PISTAO), A e atinge-se 
uma sequencia de instrugoes que correspondem novamente aos blocos 14,15, 
uma chamada a sub-rotina associada aos blocos 19 a 23, bloco 24 e finalmen- 
te bloco 5. Isto tambem foi elaborado deste modo pela facilidade de com- 
preensao, e pelo fato do movimento entre pistas ser feito em duas etapas ou 
ciclos diferentes daqueles que o "0" faz ao longo da pista. 



Grupo 10 - 17668 a 17786 (4504 a 457A em hexa) 
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Outra sub-rotina, esta ligada aos blocos 17 e 18. Como nao poderia dei- 
xar de ser, ela comega pesquisando o teclado (CALL KScan) e da-se o retor- 
no, se o jogador nao esta pressionando o zero, ou se BONUS for zero. 

0 efeito de acelerar e obtido simplesmente pelo uso do retorno ao blo- 
co 5, evitando o ramo 19, 20 etc., o que faz com que o asterisco se atrase. 
Os valores do BONUS Tela sao diminufdos de uma unidade e da-se o retor- 


Grupo 12 - 17829 a 17873 (45A5 a 45D1 em hexa) 
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Note-se que este grupo nao se constitue numa sub-rotina. Ele estd asso- 
ciado aos blocos 25 e 26 da figura 17. 

Para comegar e dado urn efeito especial no encontro do asterisco com o 
"0" e, em seguida, 6 decrementado o registro Vidas. Atingindo o zero da-se o 
retorno para o Basic, em caso contrario, urn salto para o bloco 3. 


Grupo 13 — 17874 a 18004 (45D2 a 4654 em hexa) 
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Este grupo esta ligado aos blocos 11, 12 e 13 da figura 17 e constitue 
uma sub-rotina como ja citado. 

Do enderepo 45D2 a 45ECtemos tambdm uma sub-rotina, ja conheci- 
da, com a qual a contagem de pontos na tela 6 incrementada. Esta 6 utilizada 
imediatamente adiante, nas 10 instrupoes que se seguem e correspondem aos 
blocos 11 e 12. 

As demais instrupeos vao compor o bloco 13. Primeiro o "0" 6 dese- 
nhado na posipao final e o BONUS d testado. Sendo zero nao ha o que so- 
mar, e a velocidade e aumentada, desde que nao tenha atingido o valor ma- 
ximo fixado, atrav^s da redupao do valor colocado no Registro VELOC. Se 
BONUS nao for zero, seu valor 6 somado ao Ponto Tela, um a um, por suces- 
sivas chamadas a sub-rotina citada no par2grafo anterior e, ao mesmo tempo, 
o Bonus Tela 6 reduzido igualmente. 

Antes do salto ao bloco 2 o "O" e o asterisco sao apagados. 



Grupo 14 - 18005 a 18530 (4655 a 4862 em hexa) 



4-65y 32 3E 40 LD (hCEL) , fl 

465C 2h 3F.40 LD HL,(P0SflST 

4b5F 3 h 43 40 LD H. (CONfORS’ 

46.62 77 LD (HL) ,H 

4663 32 42 40 LD fi,(DIRflST) 

466b FE 01 CP 01 

466b 20 4D JR • NZ .4687 
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4-8 Sh 


Sem duvida e 
da os movimentos 
23 da figura 17. 



0 bloco 19 & atendido pelas 5 primeiras instrupoes do grupo e onde, 
adicionalmente, o registro ACEL e feito igual a zero. 

Os dois ultimos bloco, respectivamente os 22 e 23 sao satisfeitos pelas 
5 ultimas instrupoes do grupo. Todas as demais se relacionam com os blocos 
20 e 21. As rotinas vao se sucedendo em funpao dos diferentes possfveis va- 
lores de DIRAST. Com este e pela utilizapao do PISTAST, o movimento do 
asterisco vai sendo monitorado. 




ista e a maior das sub-rotinas do programa. £ a que coman- 
do asterisco e corresponde aos blocos 19, 20, 21, 22 e 
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Grupo 17 - 1981 l a 19858 (4D63 a 4D92 em hexa) 


Afestao os dizeres para o final do jogo. 


Este grupo d responsavel pela montagem da tela inicial e pelo efeito de 
"SCROLL" e "ANTI-SCROLL". 

Entre 4CBB a 4CDC esta a rotina de impressao. Ela d monitorada pelo 
valor contido em B que vai indicar a partir de que linha o texto deve ser escri- 
to na tela. 

A chamada do Basic d para o enderepo que vem a seguir, ou seja, para 
4CDD. Entre este enderepo e 4DAC estao as instrupoes necessdrias para com- 
por a tela inicial. 0 valor de B foi feito igual a 1 e usou-se a rotina citada. 

Em 4D1 D ha ..a consulta ao teclado. Se S for pressionado dd-se o salto 
para 4D34, onde B e incrementado, desde que ainda nao tenha atingido seu 
valor maximo, que d 10. Com D o salto d para 4D41, onde B d decrementa- 
do atd o mi'nimo de 1. Em ambos os casos d sempre feita a chamada para o 
4CBB, responsavel pela escrita. 

Finalmente, se C for a tecla pressionada, dd-se o salto para 4D4E onde, 
apos a tela ser "apagada", dd-se o im'cio ao jogo. 



19783 Ob C5 CD BB 4-C IS C7 893 

19790 Cl 2R 0C 4-0 3E IS 06 4-83 

19804- Ch 32 4-8 23 00 IS FI 596 



Grupo 18 - 19859 a 19922 (4D93 a 4DD2 em hexa) 
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Este grupo cont^m as instrupoes para a*continuidade ou nao do jogo. 
Aqui termina o programa todo. 



RESUMO 

Como novidade foi visto neste capi'tulo apenas o efeito "SCROLL" e "ANTI¬ 
SCROLL" utilizado na apresentapao do jogo. 

sugestGes 

1 - Utilizando a mesma logica apresentada, alterar a pista ou tela percorri- 

da pelas figuras "0" e asterisco, de forma que o jogador possa optar 
pela que deseje utilizar. Uma alternativa seria alterar a largura, numero 
e posipao das aberturas entre as pistas. 

2 - A fim de facilitar ao jogador o contato com a dinamica da corrida, tor- 

nar a velocidade de movimento das figuras crescente, de forma que, ao 
iniciar a partida, ela seja lenta e vS gradualmente aumentando at6 que, 
ap6s por exemplo 90 pontinhos terem sido apagados, ela atinja o valor 
dito normal. 0 crescimento poderia se dar de forma contfnua ou em 
algumas etapas. 
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APENDICE B — MONITOR 


Em todos os capftulos deste volume os programas em linguagem de mci- 
quina sao listados de duas formas: 

1) Desassemblados: logo apos o sub-ti'tulo de cada grupo estao listados os co- 
mandos em tres colunas: na primeira o enderepo inicial do comando (em he¬ 
xadecimal), na segunda a sequencia de bytes do comando em codigos tambem 
hexadecimais e na terceira os mnemonicos. A analise deste tipo de listagem 
e que traz maior proveito diddtico. 

2) HeptassintSticos: esta 6 a forma mais rapida de se introduzir os cddigos e a 
mais garantida em relagao a erros de digitapao. Em compensapao a digitapao e 
feita de maneira cega pois nao aparecem os mnemonicos. 

Para digitar o programa desta forma devemos antes digitar o monitor 
listado a seguir (quern tern apenas 3 K de RAM deve obter provisoriamente 
uma expansao ate completar a digitapao). 
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procurar este numero de bytes no texto, no programinha em basic que acom- 
panha o programa principal. Por exemplo, na pdgina 33 o programinha em ba¬ 
sic mostra que a linha REM deve ter 714 bytes. 

Apos introduzir este numero, o monitor se encarrega de criar a linha 
REM com o numero de bytes pedido (preenchidos com NOPs). 

A seguir o programa pede o enderego inicial e final do grupo que estd 
sendo digitado. Estes enderegos, em decimal, deve ser procurado no sub-titu- 
lo de cada grupo. 

0 monitor apresenta na tela as mesmas 9 colunas da listagem: a primeira 
contem o enderego xio primeiro byte de linha, a seguir temos sete colunas 
contendo sequencialmente sete bytes em hexadecimal e, finalmente, na ulti¬ 
ma coluna temos a soma sintatica dos sete bytes da linha. Se a soma coincidir 
com a listada no livro, isto significa que a linha foi digitada corretamente e o 
leitor devera teclarS: os bytes serao introduzidos na linha REM e a proxima 
linha e iniciada. Se a soma nao conferir, deve-se teclar N e sua digitapao deve 
ser refeita. 

Se a digitapao do grupo seguinte nao for feita no mesmo dia, o progra¬ 
ma deve ser gravado. Ao ser recolocado no gravador devemos digitar: 

GOTO 2000 

e os enderepos inicial e final do grupo seguintes serao pedidos. 

Ao terminar o programa tome o seguinte cuidado: digite antes as linhas 
de basic do programinha sugerido no capi'tulo e so depois apague o monitor 
linha por linha. Isto se deve ao fato da linha REM ser demasiadamente longa 
e se ficar sozinha faz o sistema operacional entrar em "tilt". 


APENDICE C 
MAPA DA ROM 


0000 — Inicializagao do Sistema 

0008 — Manipulagao de erros 

0010 — Rotina que imprime um caractere 

0018 — Carrega no acumulador o byte apontado pela variavel no enderego 

16406 

0020 — Carrega no acumulador o proximo byte apontado pela variavel no 

enderego 16406 
0028 — Rotina de Calculo 

0030 — Incrementa a area de variaveis.com os numeros de byte em BC 

0038 — Rotina de interrupgao para mostrar na tela uma linha . 

0066 — Rotina de interrupgao para mostrar a tela no modo SLOW 

007E — Tabelas dos caracteres normas do teclado 

00A5 — Tabela dos caracteres SHIFT do teclado 

00CC — Tabela da.s fungoes do BASIC 

00F3 — Tabela dos caracteres graficos 

0111 — Tabela das palavras-chaves do BASIC 

01FC — Rotina de atualizagao dos comandos SAVE e LOAD 

0207 — Rotina de determinagao da velocidade (SLOW ou FAST) 

0229 — Rotina principal do display 

0292 — Rotina do display no modo SLOW. 

02B5 — Rotina do display no modo FAST 

02BB — Rotina de varredura do teclado 

02E7 — Rotina de RESET do SCL 

02F4 — Comando SAVE 

0340 — Comando LOAD 

03A2 — Teste de BREAK do comando LOAD 

03C3 — Comando NEW 

0419 — Rotina de edigao das linhas de programagao 

0454 — Rotina do cursor 

04B2 — Rotina de execugao do programa em BASIC 
052B — Rotina de construgao do Sistema E-LINE 
05C4 — Rotina de ordenagao da edigao 
063E — Rotina principal de edigao 
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072C — Comando LUST 

0730 — Comando LIST 

0745 — Rotina de impressao de uma linha BASIC 

07BD — Rotina de decodificagao do teclado 

07F1 — Rotina de impressao de uin caractere 

0808 — Rotina de impressao de urn caractere no video 

0851 — Coloca urn caractere no buffer da impressora 

0869. — Comando COPY 

08F5 — Teste dos parametros de PRINT AT 

0918 — Rotina de expansao do display 

094B —• Rotina de.impressao das palavras-chaves do BASIC 

09AD — Rotina de organizagao das variaveis 

09D8 •— Determinagao do enderego de uma linha de programa 

0A2A — Comando CLS 

0A98 — Rotina de impressao do numero da linha 

0ACB — Comando LPRINT 

0ACF — Comando PRINT 

0B6B — Rotina de impressao de uma string 

0BAF — Comando PLOT e UNPLOT 

0C0E — Comando SCROLL 

0C29 — Tabela de sintaxe dos comandos 

0CDC — Comando STOP 

0DAB — Comando IF 

0DB9 — Comando FOR 

OE2E — Comando NEXT . 

0E6C — Comando RAND 

0E7C — Comando CONT 

0E81 — Comando GOTO 

0E92 — Comando POKE 

0ED8 — Comando RETURN 

0F23 — Comando FAST 

0F2B — Comando SLOW 

0F32 — Comando PAUSE 

0F46 — Teste de BREAK do comando SAVE 

1321 — Comando LET 

1409 — Comando DIM 

149A — Comando CLEAR 

151D — Arquiva o acumulador do Stack do calculador 

1520 — Arquiva o par BC no Stack do calculador 

158A — Rotina de manipulagao dos calculos de ponto flutuante 

174C — Rotina de subtragao para numeros de 5 bytes 

1755 .— Rotina de adigao para numeros de 5 bytes 


1706 _ Rotina de multiplicagao para mimeros de 5 bytes 

1882 — Rotina de divisao para numeros de 5 bytes 

1815 — Tabela das fungoes 

199D — Calculador de ponto flutuante 

1EO0 — Tabela de definigao dos caracteres 
4000 — Inicio da RAM 

4082 — Inicio do programa em BASIC 

DFILE — Inicio do arquivo de tela 
VARS — Inicio da regiao de variaveis 
ELINE — Linha sendo digitada 4- espago de trabalho 
PILFUN •— Inicio da pilha de calculo 
PiLFIM — Inicio da pilha de calculo 
SP — Inicio da pilha para enderegar sub-rotinas 
RAMTOP — Inicio do espago que pode ser reservado para rotinas 
em linguagem de maquina 




APENDICE D — TABELA 
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